MCP-сервер 1С через OData
1C:Enterprise MCP Server for AI Assistants
MCP-сервер на чистом Python без зависимостей: поиск по метаданным 1С в памяти, чтение и запись данных через OData REST API, разбор запросов СКД
- 0 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Инструменты odata_create и odata_update пишут новые и меняют существующие записи в живой базе 1С
- Учетные данные администратора базы передаются в переменных окружения MCP-сервера
Похожий инструмент с большим сообществом: MCP-сервер OData 1С с JSON-кэшем, 4 ★ репозитория
Установка
- Работает в
- Сервисы
Ручная установка
git clone https://github.com/flakeman/fervent-hawking.gitКлонирование репозитория, дальше сервер регистрируется в конфигурации MCP-клиента.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструменты odata_create и odata_update пишут новые и меняют существующие записи в живой базе 1С
- Учетные данные администратора базы передаются в переменных окружения 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 первых документов СписаниеЗапасов через ODataMCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
1C_ODATA_URLобязательная- Адрес опубликованного OData-сервиса базы 1С.
1C_ODATA_USERобязательная- Пользователь для авторизации в OData.
1C_ODATA_PASSWORDобязательная, секрет- Пароль пользователя OData.
1C_INDEX_FILEобязательная- Путь к собранному компактному индексу метаданных.
Ограничения
Компактный индекс метаданных нужно собрать заранее скриптом build_1c_index.py и обновлять вручную после изменения конфигурации. OData нужно отдельно включить и опубликовать на веб-сервере базы, шаги описаны в отдельном руководстве. Пример конфигурации хранит логин и пароль администратора базы прямо в переменных окружения MCP-сервера в открытом виде.
Как отключить. Удалите запись 1c-helper из mcp_config.json вашего клиента.
Частые вопросы
Нужно ли ставить пакеты Python?
Нет, сервер написан на стандартной библиотеке (urllib, json), пакеты через pip ставить не нужно.
Может ли ассистент менять данные в базе?
Да, инструменты odata_create и odata_update создают и меняют записи 1С напрямую, доступ стоит давать осознанно.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер OData 1С с JSON-кэшем
MCP сервер для работы с OData 1C
Python MCP-сервер поверх OData 1С: читает и меняет справочники и документы, сохраняет все данные в JSON-файлы для локального анализа без повторных запросов
MCP-сервер OData 1С
1C OData MCP Server
Небольшой MCP-сервер на Python, который оборачивает стандартные операции чтения OData 1С:Управление предприятием в три инструмента
MCP-прокси к метаданным 1С (адаптация)
1C_MCP_SERVER_OWN
Python-прокси между MCP-клиентом и HTTP-сервисом 1С: читает метаданные, структуру объектов и предопределенные данные, с опциональным OAuth2
MCP-сервер для баз 1С:Предприятия через стандартный OData: справочники, документы, регистры и бухгалтерия без расширений в конфигурации
1С через OData: MCP-сервер на чтение
onec-odata-mcp
MCP-сервер на npx, который дает Claude доступ на чтение к базе 1С через стандартный OData без выгрузки в Excel и ручных URL
Stdio MCP-сервер, который индексирует XML-выгрузку структуры 1С и код в SQLite и отдает агенту поиск по объектам и процедурам
Из блога
Коротко о README
README описывает интеграцию для Codex и других MCP-клиентов: гибридный поиск по метаданным, доступ к данным через OData, разбор запросов СКД и файл правил SKILL.md для оптимизации запросов. Дана структура репозитория, три шага установки (клонирование, регистрация сервера в конфигурации клиента, включение OData в 1С), таблица из шести инструментов с параметрами и примеры естественноязыковых запросов к ассистенту. Отдельно упомянут документ с метриками эффективности.