MCP-сервер OData 1С с JSON-кэшем
MCP сервер для работы с OData 1C
Python MCP-сервер поверх OData 1С: читает и меняет справочники и документы, сохраняет все данные в JSON-файлы для локального анализа без повторных запросов
- 4 ★ репозитория
- Последний коммит
Широкий доступ
Почему такой уровень
- Инструменты create_1c_entity, update_1c_entity и delete_1c_document напрямую создают, меняют и удаляют документы и справочники в 1С
- Учетные данные Basic Auth хранятся в .env в открытом виде, а выгрузки сохраняются на диск локально
Установка
- Работает в
- Сервисы
Ручная установка
uv syncУстановка зависимостей.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Инструменты create_1c_entity, update_1c_entity и delete_1c_document напрямую создают, меняют и удаляют документы и справочники в 1С
- Учетные данные Basic Auth хранятся в .env в открытом виде, а выгрузки сохраняются на диск локально
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер подключается к OData API 1С по Basic Auth и дает агенту инструменты чтения метаданных и данных с автоматическим сохранением в JSON-файлы, а также CRUD-операции: создание и обновление сущностей, удаление документов и отдельное создание документов РТиУ с бизнес-правилами. Ключевая идея архитектуры в том, что функции получения данных возвращают только статус, а сама выгрузка остается в файле: дальше filter_local_data, get_file_structure и count_local_data работают с этим файлом локально, без повторных обращений к 1С, что экономит контекст модели. Есть умный поиск файлов по частичному имени и управление кэшем метаданных и данных.
Для кого. Для 1С-разработчиков и аналитиков, которым нужен агент, читающий и меняющий данные 1С через OData с сохранением выгрузок между сессиями.
Подходит, если
- Нужно выгрузить и локально анализировать большой объем данных 1С без повторных запросов к серверу
- Нужны CRUD-операции над справочниками и документами через OData из агента
- Нужно создавать документы РТиУ на основании других документов с учетом бизнес-правил
Не подходит, если
- OData-интерфейс базы не опубликован или публиковать его небезопасно для контура
- Нужна работа без сохранения данных на диск: вся архитектура сервера построена на JSON-файлах в локальном кэше
- Нужна аутентификация сильнее Basic Auth: другие способы README не описывает
Пример запроса к агенту
Выгрузи справочник Номенклатура, покажи структуру полученного файла и отсортируй первые 10 позиций по ценеMCP
- Транспорт
- sse
- Авторизация
- API-ключ
Переменные окружения
ODATA_BASE_URLобязательная- Адрес OData API базы 1С.
ODATA_USERNAMEобязательная- Логин для Basic Auth к 1С.
ODATA_PASSWORDобязательная, секрет- Пароль для Basic Auth к 1С.
Ограничения
Аутентификация к 1С только через Basic Auth, логин и пароль хранятся в .env в открытом виде. Все выгруженные данные сохраняются в JSON-файлы на диске, включая потенциально персональные данные из справочников и документов, доступ к каталогу с кэшем нужно ограничивать отдельно. Функции create_1c_document и update_1c_document помечены как устаревшие в пользу create_1c_entity и update_1c_entity. Нужен Python 3.12 и выше и настроенный OData API 1С.
Как отключить. Остановите процесс uv run main.py и удалите сервер из конфигурации MCP-клиента, кэш-файлы можно удалить вручную из рабочего каталога.
Частые вопросы
Данные из 1С запрашиваются каждый раз заново?
Нет, fetch_1c_data сохраняет выгрузку в JSON-файл один раз, а дальнейший анализ через filter_local_data и count_local_data идет по этому файлу локально.
Можно удалить документ через этот сервер?
Да, инструмент delete_1c_document удаляет документ из 1С, это операция записи и стоит ограничивать доступ к серверу.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер OData 1С
1C OData MCP Server
Небольшой MCP-сервер на Python, который оборачивает стандартные операции чтения OData 1С:Управление предприятием в три инструмента
MCP-сервер для данных 1С:Предприятия через OData: дебиторка, продажи, остатки и деньги, а по отдельному флагу создание и проведение документов
MCP-сервер для баз 1С:Предприятия через стандартный OData: справочники, документы, регистры и бухгалтерия без расширений в конфигурации
MCP-прокси к метаданным 1С (адаптация)
1C_MCP_SERVER_OWN
Python-прокси между MCP-клиентом и HTTP-сервисом 1С: читает метаданные, структуру объектов и предопределенные данные, с опциональным OAuth2
1С через OData: MCP-сервер на чтение
onec-odata-mcp
MCP-сервер на npx, который дает Claude доступ на чтение к базе 1С через стандартный OData без выгрузки в Excel и ручных URL
Read-only MCP-сервер стандартного OData 1С
python-1c-mcp
Опубликованный на PyPI read-only MCP-сервер для стандартного OData 1С:Предприятие 8.3.5+: схема, запросы с фильтрами, поиск записи по Ref_Key
Альтернативы
Инструменты других авторов для тех же задач.
Коротко о README
README перечисляет возможности сервера: метаданные, запросы данных, локальную фильтрацию, CRUD-операции, специальные документы РТиУ, аутентификацию Basic Auth и JSON-архитектуру с обоснованием экономии контекста LLM. Дает быстрый старт через uv sync и .env, пример подключения по SSE, полный список инструментов по группам, примеры кода для создания и обновления сущностей, описание умного поиска файлов по частичному имени и ссылку на architecture.md для деталей.