Read-only MCP-сервер стандартного OData 1С
python-1c-mcp
Опубликованный на PyPI read-only MCP-сервер для стандартного OData 1С:Предприятие 8.3.5+: схема, запросы с фильтрами, поиск записи по Ref_Key
- 0 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Через OData видны все опубликованные данные базы 1С, в том числе контрагенты и сотрудники, то есть персональные данные
- Запускает сервер, который читает данные базы 1С через опубликованный OData
- Инструментов создания, изменения и проведения документов в пакете нет
Установка
- Работает в
- Сервисы
Ручная установка
pip install python-1c-mcpУстановка пакета с PyPI.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Через OData видны все опубликованные данные базы 1С, в том числе контрагенты и сотрудники, то есть персональные данные
- Запускает сервер, который читает данные базы 1С через опубликованный OData
- Инструментов создания, изменения и проведения документов в пакете нет
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер, построенный поверх библиотеки 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 рублейMCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
ONEC_SERVERобязательная- Базовый URL сервера 1С, например http://1c.example.
ONEC_INFOBASEобязательная- Имя публикации информационной базы.
ONEC_PASSWORDобязательная, секрет- Пароль пользователя OData.
ONEC_URLсекрет- Единая ссылка с логином и паролем вместо четырех отдельных переменных.
Ограничения
Работает только со стандартной публикацией 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-клиента.
Частые вопросы
Есть ли способ что-то изменить через этот сервер?
Нет, инструментов создания, изменения, удаления, проведения и снятия с проведения в пакете нет вообще, это read-only сервер по дизайну.
Как публиковать OData в 1С для этого сервера?
Через пункт «Публикация на веб-сервере» в меню «Администрирование» с включенным стандартным интерфейсом OData, путь сервиса /odata/standard.odata.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер OData 1С
1C OData MCP Server
Небольшой MCP-сервер на Python, который оборачивает стандартные операции чтения OData 1С:Управление предприятием в три инструмента
MCP-сервер OData 1С с JSON-кэшем
MCP сервер для работы с OData 1C
Python MCP-сервер поверх OData 1С: читает и меняет справочники и документы, сохраняет все данные в JSON-файлы для локального анализа без повторных запросов
1С через OData: MCP-сервер на чтение
onec-odata-mcp
MCP-сервер на npx, который дает Claude доступ на чтение к базе 1С через стандартный OData без выгрузки в Excel и ручных URL
MCP-прокси к метаданным 1С (адаптация)
1C_MCP_SERVER_OWN
Python-прокси между MCP-клиентом и HTTP-сервисом 1С: читает метаданные, структуру объектов и предопределенные данные, с опциональным OAuth2
MCP-сервер для данных 1С:Предприятия через OData: дебиторка, продажи, остатки и деньги, а по отдельному флагу создание и проведение документов
MCP-сервер для баз 1С:Предприятия через стандартный OData: справочники, документы, регистры и бухгалтерия без расширений в конфигурации
Из блога
Коротко о README
Двуязычный README подчеркивает read-only область действия с самого начала, объясняет публикацию OData со стороны 1С в три шага, дает таблицу переменных подключения включая альтернативный ONEC_URL, таблицу из пяти MCP-инструментов и двух ресурсов, отдельный раздел «чего еще нет» с явным списком write-инструментов и других протоколов, и завершается блоком для разработки с pytest, ruff и mypy.