MCP-сервер внутри 1С

1c_mcp

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

MCP-серверВысокий рискРоссийский стек

vladimir-kharin/1c_mcp

Установка

cp .env.docker.example .env
docker-compose up -d

Запуск Python-прокси в Docker. В .env задайте адрес 1С, логин и пароль; если 1С на том же хосте, используйте host.docker.internal.

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

Что делает

Проект берет на себя протокол MCP внутри 1С:Предприятия, а разработчику остается описать бизнес-логику инструментов. Готовое расширение публикуется как HTTP-сервис, и агент получает инструменты для чтения метаданных конфигурации. Свой инструмент добавляется обработкой с двумя экспортными методами: описание параметров и выполнение. Кроме инструментов поддерживаются ресурсы и промпты. Опциональный прокси на Python дает транспорт stdio и OAuth2, чтобы не отключать аутентификацию 1С на веб-сервере.

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

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

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

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

  • Нельзя публиковать HTTP-сервисы базы на веб-сервере
  • Нужен анализ выгрузки исходников без запущенной базы

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

Посмотри через MCP структуру документа РеализацияТоваровУслуг и перечисли его табличные части

Ограничения

Нужна публикация HTTP-сервиса 1С на веб-сервере. Прямое подключение без прокси требует публикации базы без аутентификации, что небезопасно, и не работает с клиентами на stdio. Регистр имени базы в адресе должен совпадать с именем публикации.

Как отключить. Отключите расширение MCP_Сервер в конфигурации и снимите публикацию HTTP-сервиса, удалите сервер из настроек клиента.

MCP

Транспорт
http
Авторизация
не нужна
Переменные окружения
Переменные окружения
MCP_ONEC_URL
обязательная
Адрес HTTP-сервиса 1С для прокси

Проверка безопасности

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

Коротко о README

README объясняет состав проекта: расширение 1С как ядро и опциональный прокси на Python. Быстрый старт состоит из трех шагов: подключить cfe, опубликовать HTTP-сервис и подключить клиент, примеры настроек лежат в mcp_client_settings. Описаны три варианта подключения, включая запуск прокси в Docker, и порядок разработки своих инструментов. Есть видео о проекте, лицензия MIT.

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

Зачем нужен Python-прокси?

Он подключает клиенты на stdio и реализует OAuth2, передавая авторизацию в 1С через Basic Auth, так что аутентификацию базы отключать не нужно.

Можно ли держать свои инструменты отдельно?

Да, в отдельном расширении с копией подсистемы mcp_MCPСервер под своим префиксом, движок найдет ее сам.

Выбор редакции

Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода

ПлагинСредний риск286,7 тыс.
Выбор редакции

Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура

СкиллНизкий риск262,1 тыс.
Выбор редакции

Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации

CLIСредний риск136,8 тыс.

Референсные MCP-серверы

Model Context Protocol servers

Выбор редакции

Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything

MCP-серверСредний риск90,3 тыс.