MCP для чтения данных 1С через OData
1c-mcp
MCP-сервер на TypeScript для доступа к 1С через OData, только чтение: поиск объектов, карточка сущности, связанные записи
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Инструменты только читают данные через OData, запись в 1С не поддержана
Установка
Ручная установка
pnpm install && cp .env.example .env && pnpm build && pnpm --filter @carely/1c-mcp startКоманды из README: установка зависимостей, копирование конфига окружения, сборка и запуск сервера.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер обращается к 1С по протоколу OData и отдает агенту инструменты для чтения: список доступных источников данных, описание возможностей подключения, поиск сущностей, получение карточки объекта и поиск связанных записей. Есть проверка состояния подключения и инвентаризация инструментов. Автор прямо пишет, что это ранняя версия: часть бизнес-логики из прежнего Python-прототипа еще не перенесена, а структура проекта повторяет два других его MCP-сервера.
Для кого. Для разработчиков, которым нужен безопасный, только для чтения доступ агента к данным 1С через OData без риска что-то изменить.
Подходит, если
- Нужно, чтобы агент читал справочники и документы 1С через OData без прав на запись
- Есть настроенная публикация OData у базы 1С и нужен MCP-мост к ней
- Нужна отправная точка для своего TypeScript MCP поверх 1С
Не подходит, если
- Нужна запись данных в 1С: сервер читает, но не пишет
- Нужны готовые бизнес-сценарии: автор пишет, что часть логики прототипа еще не перенесена
- Нет публикации OData у базы 1С
Пример запроса к агенту
Найди в 1С контрагента по названию и покажи связанные с ним документыОграничения
Проект в раннем состоянии, 0 звезд, без релизов и стабильной версии. Только чтение, ничего не изменяет в 1С. Нужна настроенная публикация OData на стороне 1С и переменные окружения из .env.example. Часть бизнес-логики из Python-прототипа автора еще не перенесена.
Как отключить. Остановите процесс сервера и удалите его из конфигурации MCP клиента.
MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| ONEC_INTERFACE_MODE | Установите mock для смок-тестов без реальной базы 1С. |
Проверка безопасности
- Инструменты только читают данные через OData, запись в 1С не поддержана
Коротко о README
README описывает TypeScript MCP-сервер для чтения 1С ERP через OData, дает команды быстрого старта на pnpm, режим mock для тестов без реальной базы и список из семи инструментов: инвентаризация, healthcheck, список источников, описание возможностей, поиск сущностей, карточка сущности и поиск связанных записей.
Частые вопросы
Сервер может изменить данные в 1С?
Нет, README прямо указывает, что инструменты только читают через OData.
Можно проверить сервер без реальной базы 1С?
Да, для смок-тестов есть режим ONEC_INTERFACE_MODE=mock.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything