MCP-прокси к метаданным 1С (адаптация)
1C_MCP_SERVER_OWN
Python-прокси между MCP-клиентом и HTTP-сервисом 1С: читает метаданные, структуру объектов и предопределенные данные, с опциональным OAuth2
Низкий риск
Низкий уровень ставим, когда запись в основном дает агенту инструкции и справочные материалы.
Почему такой уровень
- Инструменты только читают метаданные и предопределенные элементы, запись в базу не описана
- Учетные данные 1С хранятся в .env или переменных окружения на сервере
Установка
Ручная установка
python -m src.py_server stdioStdio-режим для локальных клиентов, переменные MCP_ONEC_URL, MCP_ONEC_USERNAME, MCP_ONEC_PASSWORD задаются перед запуском.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер переводит вызовы MCP в JSON-RPC запросы к HTTP-сервису 1С, опубликованному в базе как расширение. Доступны четыре инструмента: список объектов метаданных по типу и маске имени, подробная структура объекта с реквизитами и табличными частями, список и детальная информация о предопределенных элементах справочников. Работает в двух режимах: stdio для локальных клиентов вроде Claude Desktop и Cursor, и HTTP с эндпоинтами /mcp/, /sse, /health, /info для веб-сценариев и нескольких пользователей одновременно. В HTTP-режиме можно включить OAuth2 с password grant или authorization code plus PKCE, чтобы каждый клиент подключался под своими учетными данными 1С, а не под одной общей.
Для кого. Для 1С-разработчиков, которым нужен готовый MCP-мост к метаданным конкретной базы 1С без написания собственного HTTP-сервиса с нуля.
Подходит, если
- Нужно, чтобы агент читал список и структуру объектов метаданных конкретной базы 1С
- Нужен доступ к предопределенным элементам справочников через естественный язык
- Несколько пользователей должны подключаться к серверу под своими учетными данными 1С через OAuth2
Не подходит, если
- Нужна запись данных в 1С, а не только чтение метаданных и предопределенных элементов
- Нет возможности опубликовать HTTP-сервис расширения 1С по адресу /hs/mcp/rpc
- Нужен независимый проект, а не адаптация чужой разработки: автор прямо указывает исходный репозиторий vladimir-kharin/1c_mcp
Пример запроса к агенту
Покажи структуру справочника Номенклатура с реквизитами и табличными частямиОграничения
README прямо называет проект доработкой и адаптацией github.com/vladimir-kharin/1c_mcp под собственные задачи автора, поэтому часть архитектурных решений унаследована оттуда. Без OAuth2 все запросы идут от одного пользователя, указанного в конфигурации. Нужен опубликованный HTTP-сервис расширения 1С на стороне базы, инструкция по его установке в README отсутствует, есть только клиентская часть на Python. В README упомянут файл testMCP.md с результатами тестирования, но не описан состав автотестов подробно.
Как отключить. Остановите процесс python -m src.py_server и удалите сервер из конфигурации MCP-клиента.
MCP
- Транспорт
- stdio, http, sse
- Авторизация
- API-ключ
| Переменные окружения | |
|---|---|
| MCP_ONEC_URL обязательная | URL базы 1С с опубликованным HTTP-сервисом. |
| MCP_ONEC_USERNAME обязательная | Имя пользователя 1С, обязательно без OAuth2. |
| MCP_ONEC_PASSWORD обязательная, секрет | Пароль пользователя 1С, обязателен без OAuth2. |
Проверка безопасности
- Инструменты только читают метаданные и предопределенные элементы, запись в базу не описана
- Учетные данные 1С хранятся в .env или переменных окружения на сервере
Коротко о README
README на русском объясняет назначение прокси-сервера между MCP-клиентами и HTTP-сервисом 1С, дает быстрый старт для stdio и HTTP режимов, документирует четыре API-метода с примерами JSON, таблицу параметров конфигурации, настройки OAuth2 с таймаутами токенов, схему архитектуры и раздел устранения неполадок. В начале и в конце указан исходный проект vladimir-kharin/1c_mcp, на основе которого сделана адаптация. Лицензия MIT.
Частые вопросы
Можно ли писать данные в 1С через этот сервер?
Нет, README описывает только инструменты чтения: список объектов метаданных, структура объекта и предопределенные элементы.
Обязателен ли OAuth2?
Нет, по умолчанию режим авторизации none и все запросы выполняются от одного пользователя из конфигурации.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything