1C MCP Toolkit
Внешняя обработка 1С с MCP и REST API: запросы, метаданные, журнал регистрации и выполнение кода без изменения конфигурации
Установка
docker run -d -p 6003:6003 -e ALLOW_DANGEROUS_WITH_APPROVAL=true --restart unless-stopped --name 1c-mcp-toolkit-proxy roctup/1c-mcp-toolkit-proxyРежим прокси. В обработке укажите URL прокси http://localhost:6003 и нажмите подключиться.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Инструмент подключает агента к базе 1С через внешнюю обработку, поэтому конфигурацию менять и базу публиковать не нужно. Во встроенном режиме HTTP-сервер поднимается прямо в обработке, в режиме прокси обработка забирает команды у сервера на Python. Агент выполняет запросы на языке 1С, смотрит метаданные, журнал регистрации, права и ссылки на объекты, получает справку по BSL и может выполнить произвольный код. Есть анонимизация: реальные значения заменяются токенами и возвращаются обратно при ответе.
Для кого. Для 1С-разработчиков и аналитиков, которым нужен агент с доступом к данным базы без доработки конфигурации.
Подходит, если
- Нельзя менять конфигурацию или публиковать базу на веб-сервере
- Агенту нужно выполнять запросы к данным и смотреть журнал регистрации
- Нужно скрыть персональные данные от облачной модели
Не подходит, если
- Нельзя разрешать выполнение кода в рабочей базе
- Нужен анализ исходников без запущенного клиента 1С
Пример запроса к агенту
Выбери через MCP десять последних документов реализации с суммой и контрагентомОграничения
Обработка должна быть открыта в запущенном клиенте 1С. Встроенный сервер по умолчанию без аутентификации, токен включается в форме. Скриншоты окна работают только в Windows, на macOS встроенному серверу нужны собранные нативные компоненты. Лицензия GPL-3.0.
Как отключить. Остановите сервер и закройте обработку в 1С, остановите контейнер прокси и удалите сервер из настроек клиента.
MCP
- Транспорт
- http
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| ALLOW_DANGEROUS_WITH_APPROVAL | Разрешить опасные операции с подтверждением в режиме прокси |
| ANONYMIZATION_ENABLED | Включить анонимизацию данных в режиме прокси |
Проверка безопасности
- Инструмент execute_code выполняет произвольный код в базе 1С
- Читает рабочие данные, включая персональные
- Встроенный сервер по умолчанию без аутентификации
Коротко о README
README описывает два варианта архитектуры, встроенный сервер и прокси, и быстрый старт для каждого, включая образ на Docker Hub. Приведены настройки для Kiro и Claude Desktop, аутентификация по токену, таблица MCP-инструментов и REST-эндпоинтов. Разделы про анонимизацию, черный список опасных операций и изоляцию каналов. В папке skills лежат скиллы для работы через REST API и составления запросов 1С.
Частые вопросы
Как подключить Claude Desktop?
Его конфиг понимает только stdio, поэтому README предлагает мост mcp-remote через npx или custom connector на платных планах.
Как разделить тестовую и рабочую базу?
Через ID канала: один прокси, разные параметры channel в адресе и в настройках обработки.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything