MCP-сервер внутри 1С
1c_mcp
Расширение 1С, которое поднимает MCP-сервер прямо в базе: инструменты по метаданным из коробки и свои инструменты на BSL
Установка
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, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything