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

1c_mcp

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

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

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

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

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

vladimir-kharin/1c_mcp

Установка

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

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

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

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

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

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

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

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

Что делает

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

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

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

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

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

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

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

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

MCP

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

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

MCP_ONEC_URL обязательная
Адрес HTTP-сервиса 1С для прокси

Ограничения

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

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

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

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

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

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

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

Обсуждение

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

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

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

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

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

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

Расширение 1С с обработками-контейнерами MCP-инструментов, прикладной слой архитектуры, где транспорт и агрегацию дают отдельные компоненты

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

Python-прокси между MCP-клиентом и HTTP-сервисом 1С: читает метаданные, структуру объектов и предопределенные данные, с опциональным OAuth2

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

MCP-сервер поверх HTTP-сервиса расширения 1С: отдает структуру метаданных конфигурации, ищет объекты и проверяет синтаксис запросов

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

Из блога

Коротко о README

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

Бейдж для README

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

Foxx AIMCP-сервер внутри 1С
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.