Read-only MCP-сервер стандартного OData 1С
python-1c-mcp
Опубликованный на PyPI read-only MCP-сервер для стандартного OData 1С:Предприятие 8.3.5+: схема, запросы с фильтрами, поиск записи по Ref_Key
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Пакет физически не содержит инструментов записи, изменения или удаления данных
Установка
Ручная установка
pip install python-1c-mcpУстановка пакета с PyPI.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер, построенный поверх библиотеки python-1c-odata, дает read-only доступ к опубликованному стандартному интерфейсу OData 1С: список и описание наборов сущностей из $metadata, запросы с $filter, $select, $top, $skip, $orderby и $inlinecount, получение одной записи по Ref_Key и просмотр сырого или суммарного $metadata. Никаких инструментов создания, изменения, удаления, проведения или снятия с проведения в сервере нет вообще, это явно заявленная граница. Поддерживаются публикации от 8.3.5 (формат Atom) до текущих версий с JSON по умолчанию.
Для кого. Для разработчиков и аналитиков, которым нужен безопасный, гарантированно read-only доступ к данным 1С через стандартный OData без риска случайной записи.
Подходит, если
- Нужен предсказуемо безопасный доступ к данным 1С без единого инструмента записи
- Нужен быстрый запрос по стандартному OData с фильтрами и постраничной выборкой
- Нужна работа со старой публикацией 8.3.5 в формате Atom
Не подходит, если
- Нужна запись данных: create, update, delete и посты не реализованы принципиально
- Нужны 8.2, 7.7, SOAP, COM или собственные HTTP-сервисы: сервер говорит только со стандартным OData
Пример запроса к агенту
Покажи структуру Catalog_Товары и найди первые 20 товаров дороже 1000 рублейОграничения
Работает только со стандартной публикацией OData 3.0 на платформе 8.3.5 и новее, других протоколов (8.2, 7.7, SOAP, COM, /hs/) не поддерживает. Публикации 8.3.5 говорят только Atom, для них нужно явно указать ONEC_FORMAT=atom. list_entity_sets усекает список после 500 элементов.
Как отключить. Удалите запись 1c-odata из конфигурации MCP-клиента.
MCP
- Транспорт
- stdio
- Авторизация
- не нужна
| Переменные окружения | |
|---|---|
| ONEC_SERVER обязательная | Базовый URL сервера 1С, например http://1c.example. |
| ONEC_INFOBASE обязательная | Имя публикации информационной базы. |
| ONEC_PASSWORD обязательная, секрет | Пароль пользователя OData. |
| ONEC_URL секрет | Единая ссылка с логином и паролем вместо четырех отдельных переменных. |
Проверка безопасности
- Пакет физически не содержит инструментов записи, изменения или удаления данных
Коротко о README
Двуязычный README подчеркивает read-only область действия с самого начала, объясняет публикацию OData со стороны 1С в три шага, дает таблицу переменных подключения включая альтернативный ONEC_URL, таблицу из пяти MCP-инструментов и двух ресурсов, отдельный раздел «чего еще нет» с явным списком write-инструментов и других протоколов, и завершается блоком для разработки с pytest, ruff и mypy.
Частые вопросы
Есть ли способ что-то изменить через этот сервер?
Нет, инструментов создания, изменения, удаления, проведения и снятия с проведения в пакете нет вообще, это read-only сервер по дизайну.
Как публиковать OData в 1С для этого сервера?
Через Администрирование → Публикация на веб-сервере с включенным стандартным интерфейсом OData, путь сервиса /odata/standard.odata.
Из блога
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything