MCP-сервер тестовой базы 1С по HTTP
1C Base MCP
MCP-сервер для тестовой базы 1С через V83.COMConnector с HTTP-транспортом, токеном доступа и переключаемым режимом только чтения
- 0 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- create_document и execute_code способны писать в базу и выполнять произвольный код, если MCP_READONLY выключен
- Доступ защищен единственным токеном, ответственность за сетевую изоляцию лежит на пользователе
Установка
- Работает в
- Сервисы
Ручная установка
python -m pip install -r requirements-server.txtУстановка зависимостей сервера на машине с 1С.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- create_document и execute_code способны писать в базу и выполнять произвольный код, если MCP_READONLY выключен
- Доступ защищен единственным токеном, ответственность за сетевую изоляцию лежит на пользователе
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер запускается рядом с 1С на Windows, открывает COM-соединение и публикует инструменты по Streamable HTTP: list_metadata, describe_object, run_query для чтения, count_data для подсчета, а также create_element, create_document и execute_code для записи и произвольного кода через внешнюю обработку runner.epf. Инструменты записи и execute_code заблокированы, пока переменная MCP_READONLY выставлена в true, что задано по умолчанию. Локальный Python-мост mcp_bridge.py позволяет подключать stdio-клиенты к HTTP-серверу по токену, а доступ можно ограничить списком разрешенных префиксов IP.
Для кого. Для разработчиков 1С, которым нужен сетевой MCP-доступ к изолированной тестовой или демо-базе с контролируемым включением записи.
Подходит, если
- Нужен сетевой доступ агента к тестовой базе 1С с нескольких машин
- Нужен контролируемый режим записи, включаемый только на время задачи
- Нужен подсчет и структура объектов без ручного захода в конфигуратор
Не подходит, если
- Нужна работа с продуктивной базой: проект явно предназначен только для изолированной демо- или тестовой базы
- Нужен доступ без Windows: серверная часть требует COM и платформу 1С:Предприятие 8.3 на Windows
Пример запроса к агенту
Посчитай количество элементов в справочнике Контрагенты и покажи структуру документа РеализацияТоваровУслугMCP
- Транспорт
- http, stdio
- Авторизация
- API-ключ
Переменные окружения
ONEC_SRVRобязательная- Кластер-сервер тестовой базы 1С.
MCP_AUTH_TOKENобязательная, секрет- Токен доступа к HTTP-серверу.
MCP_READONLY- Блокирует запись и execute_code, по умолчанию true.
Ограничения
Автор прямо пишет: проект предназначен только для изолированной демо- или тестовой базы. Инструменты записи и execute_code выключены по умолчанию, но включаются одной переменной окружения, поэтому дисциплина эксплуатации целиком на пользователе. Параметр ?token= поддержан только для совместимости и может попасть в журналы или историю.
Как отключить. Остановите процесс mcp_base_server.py и уберите сервер из конфигурации stdio-клиента.
Частые вопросы
Как включить запись данных?
Явно выставить переменную окружения MCP_READONLY в false, по умолчанию она true и блокирует запись и execute_code.
Как ограничить доступ по сети?
Переменной MCP_ALLOWED_IP_PREFIXES с перечислением разрешенных префиксов IP через запятую, плюс обязательный MCP_AUTH_TOKEN.
Обсуждение
Вопросов и отзывов пока нет.
Расширение 1С с двумя HTTP-эндпоинтами (query и exec) плюс Python MCP-обертка для Claude Code, рассчитанное только на тестовую базу
MCP-сервер 1С через COM-соединение
mcp-1c-com
MCP-сервер на Python, подключающийся к информационной базе 1С через V83.COMConnector без установки расширения в саму базу
MCP-сервер для инфобаз 1С через COM
1C MCP Server
Python MCP-сервер на Windows, который подключается к файловым и серверным базам 1С через COMConnector и хранит профили подключений с паролями под DPAPI
Универсальный MCP-сервер 1С (только чтение)
Universal 1C MCP Server (Read-Only)
Строго read-only MCP-сервер поверх HTTP-сервиса 1С: 39 инструментов для метаданных, запросов, бухгалтерии и отчетов
MCP-сервер внутри 1С
1c_mcp
Расширение 1С, которое поднимает MCP-сервер прямо в базе: инструменты по метаданным из коробки и свои инструменты на BSL
MCP-сервер в клиенте 1С
1C Client MCP Server
Расширение 1С, которое поднимает MCP-сервер прямо внутри клиента 1С:Предприятия и позволяет описывать свои инструменты на BSL
Коротко о README
README сразу предупреждает, что проект только для изолированной демо- или тестовой базы, описывает архитектуру клиент-мост-сервер-COM, список переменных окружения для подключения к 1С и настроек безопасности, шаги установки на сервере и клиенте, скрипт проверки MCP-рукопожатия check_mcp_base.py и раздел безопасности с рекомендациями по токену, файрволу и ограничению IP.