MCP-сервер 1С через COM-соединение

mcp-1c-com

MCP-сервер на Python, подключающийся к информационной базе 1С через V83.COMConnector без установки расширения в саму базу

  • 0 ★ репозитория
  • Последний коммит
MCP-сервер

Широкий доступ

Почему такой уровень

  • execute_script при отключенной защите выполняет произвольный код 1С через операторы Выполнить и Вычислить
  • COM-доступ дает чтение и потенциальную запись данных информационной базы под правами указанного пользователя
Все причины и проверки
Российский стек

spritelutsk/mcp-1c-com

Установка

Ручная установка

claude mcp add 1c-com -- "<путь>\.venv\Scripts\python.exe" "<путь>\server.py"

Команда из README для подключения сервера к Claude Code.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • execute_script при отключенной защите выполняет произвольный код 1С через операторы Выполнить и Вычислить
  • COM-доступ дает чтение и потенциальную запись данных информационной базы под правами указанного пользователя

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Сервер открывает внешнее COM-соединение к базе 1С и дает пять инструментов: execute_query выполняет запрос на встроенном языке запросов с параметрами и лимитом строк, list_metadata перечисляет объекты метаданных по видам, describe_object показывает реквизиты и табличные части объекта с типами, connection_info проверяет соединение и версии, а execute_script выполняет произвольный код или вычисляет выражение через отдельную обработку-исполнитель, потому что внешнее COM-соединение само по себе не поддерживает операторы Выполнить и Вычислить.

Для кого. Для разработчиков 1С на Windows, которым нужен MCP-доступ к базе без установки расширения внутрь самой конфигурации.

Подходит, если

  • Нужен быстрый запрос к базе 1С без изменения самой конфигурации
  • Нужно получить структуру объекта конфигурации по имени
  • Нужно выполнить разовый код 1С через агента для отладки

Не подходит, если

  • Работа идет не на Windows: COM-коннектор доступен только там
  • Нужна безопасная работа с продуктивной базой: execute_script при включенной защите может выполнить произвольный код

Пример запроса к агенту

Покажи структуру справочника Контрагенты и выполни запрос по документам продаж за январь

MCP

Транспорт
stdio
Авторизация
не нужна

Переменные окружения

ONEC_FILE
Путь к файловой информационной базе.
ONEC_SRVR
Имя кластер-сервера для серверной базы.
ONEC_PWD секрет
Пароль пользователя 1С.

Ограничения

Работает только на Windows с установленной платформой 1С:Предприятие 8.3 и требует совпадения разрядности Python и comcntr.dll. Ссылки в результатах запроса возвращаются как UUID без представления, если явно не запросить ПРЕДСТАВЛЕНИЕ. Инструмент execute_script требует отключить «Защиту от опасных действий» для пользователя ИБ, что явно ослабляет защиту от случайных вызовов Выполнить и Вычислить.

Как отключить. Удалите сервер 1c-com из .mcp.json проекта, командой claude mcp remove 1c-com в Claude Code.

Частые вопросы

Почему execute_script требует отдельную обработку?

Потому что операторы Выполнить и Вычислить это конструкции языка, а не методы глобального контекста, и внешнее COM-соединение их напрямую не отдает.

Что означает ошибка TYPE_E_LIBNOTREGISTERED?

Не зарегистрирована библиотека типов коннектора, лечится повторной регистрацией comcntr.dll от имени администратора.

Обсуждение

Вопросов и отзывов пока нет.

Российский стек

Python MCP-сервер на Windows, который подключается к файловым и серверным базам 1С через COMConnector и хранит профили подключений с паролями под DPAPI

MCP-серверРасширенный доступ1Звезды репозитория
Российский стек

MCP-сервер для тестовой базы 1С через V83.COMConnector с HTTP-транспортом, токеном доступа и переключаемым режимом только чтения

MCP-серверШирокий доступ
Российский стек

Расширение 1С, которое поднимает MCP-сервер прямо в базе: инструменты по метаданным из коробки и свои инструменты на BSL

MCP-серверШирокий доступ574Звезды репозитория
Российский стек

Нативный компонент, который поднимает полноценный MCP-сервер внутри 1С: инструменты, ресурсы, промпты пишутся на BSL, а протокол берет на себя DLL

MCP-серверШирокий доступ43Звезды репозитория
Российский стек

Десять MCP-серверов для разработки 1С: справка платформы, точечная выгрузка и загрузка объектов, COM, хранилище, поиск по файлам и BSL Language Server

MCP-серверШирокий доступ1Звезды репозитория
Российский стек

Расширение 1С на основе vladimir-kharin/1c_mcp, которое добавляет выполнение произвольного кода встроенного языка прямо в контексте информационной базы

MCP-серверШирокий доступ5Звезды репозитория

Коротко о README

README перечисляет пять MCP-инструментов, требования к разрядности Python и comcntr.dll, конфигурацию через переменные окружения для файловой и серверной базы, подключение к Claude Code через .mcp.json, отдельный раздел про execute_script с обработкой-исполнителем и необходимостью снять «Защиту от опасных действий», а также диагностику типичных COM-ошибок.

Бейдж для README

Сообщить о проблеме