MCP-сервер 1С через OData
1C:Enterprise MCP Server for AI Assistants
MCP-сервер на чистом Python без зависимостей: поиск по метаданным 1С в памяти, чтение и запись данных через OData REST API, разбор запросов СКД
Высокий риск
Высокий уровень ставим, когда инструмент пишет во внешние системы, работает с деньгами, рабочими базами или секретами либо выполняет произвольные команды. CLI поставит его только после вашего согласия.
Почему такой уровень
- Инструменты odata_create и odata_update пишут новые и меняют существующие записи в живой базе 1С
- Учетные данные администратора базы передаются в переменных окружения MCP-сервера
Установка
Ручная установка
git clone https://github.com/flakeman/fervent-hawking.gitКлонирование репозитория, дальше сервер регистрируется в конфигурации MCP-клиента.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер сочетает два способа доступа к конфигурации 1С: компактный индекс метаданных в памяти для мгновенного поиска справочников, документов и регистров по ключевому слову, и статический поиск по распакованной XML-выгрузке конфигурации. Отдельно даны инструменты для живых данных через OData: чтение с фильтром и сортировкой, создание записи и обновление по GUID. Инструмент extract_xml_query достает текст запроса 1С прямо из XML-файла шаблона схемы компоновки данных. Файл SKILL.md учит модель писать запросы с учетом правил оптимизации СУБД, например фильтровать в параметрах виртуальной таблицы вместо условия ГДЕ. Сервер написан на стандартной библиотеке Python без внешних зависимостей.
Для кого. Для 1С-разработчиков, которые используют Codex, Gemini CLI, Cursor или Windsurf и хотят дать агенту доступ к метаданным конфигурации и живым данным базы через OData.
Подходит, если
- Нужен быстрый поиск объектов конфигурации по ключевому слову без обращения к базе
- Нужно читать, создавать или обновлять записи 1С через OData прямо из чата с ассистентом
- Нужно достать текст запроса СКД из XML-шаблона без открытия Конфигуратора
Не подходит, если
- OData не опубликован на веб-сервере базы: инструменты odata_* без него не работают
- Не готовы давать агенту право на создание и изменение записей через odata_create и odata_update
Пример запроса к агенту
Найди все справочники и регистры со словом Запасы и выведи 10 первых документов СписаниеЗапасов через ODataОграничения
Компактный индекс метаданных нужно собрать заранее скриптом build_1c_index.py и обновлять вручную после изменения конфигурации. OData нужно отдельно включить и опубликовать на веб-сервере базы, шаги описаны в отдельном руководстве. Пример конфигурации хранит логин и пароль администратора базы прямо в переменных окружения MCP-сервера в открытом виде.
Как отключить. Удалите запись 1c-helper из mcp_config.json вашего клиента.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| 1C_ODATA_URL обязательная | Адрес опубликованного OData-сервиса базы 1С. |
| 1C_ODATA_USER обязательная | Пользователь для авторизации в OData. |
| 1C_ODATA_PASSWORD обязательная, секрет | Пароль пользователя OData. |
| 1C_INDEX_FILE обязательная | Путь к собранному компактному индексу метаданных. |
Проверка безопасности
- Инструменты odata_create и odata_update пишут новые и меняют существующие записи в живой базе 1С
- Учетные данные администратора базы передаются в переменных окружения MCP-сервера
Коротко о README
README описывает интеграцию для Codex и других MCP-клиентов: гибридный поиск по метаданным, доступ к данным через OData, разбор запросов СКД и файл правил SKILL.md для оптимизации запросов. Дана структура репозитория, три шага установки (клонирование, регистрация сервера в конфигурации клиента, включение OData в 1С), таблица из шести инструментов с параметрами и примеры естественноязыковых запросов к ассистенту. Отдельно упомянут документ с метриками эффективности.
Частые вопросы
Нужно ли ставить пакеты Python?
Нет, сервер написан на стандартной библиотеке (urllib, json), пакеты через pip ставить не нужно.
Может ли ассистент менять данные в базе?
Да, инструменты odata_create и odata_update создают и меняют записи 1С напрямую, доступ стоит давать осознанно.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything