MCP-прокси к метаданным 1С (адаптация)
1C_MCP_SERVER_OWN
Python-прокси между MCP-клиентом и HTTP-сервисом 1С: читает метаданные, структуру объектов и предопределенные данные, с опциональным OAuth2
- 9 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Запускает сервер, который по учетной записи 1С обращается к HTTP-сервису базы
- Инструменты только читают метаданные и предопределенные элементы
Установка
- Работает в
- Сервисы
Ручная установка
python -m src.py_server stdioStdio-режим для локальных клиентов, переменные MCP_ONEC_URL, MCP_ONEC_USERNAME, MCP_ONEC_PASSWORD задаются перед запуском.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает сервер, который по учетной записи 1С обращается к HTTP-сервису базы
- Инструменты только читают метаданные и предопределенные элементы
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер переводит вызовы 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
Пример запроса к агенту
Покажи структуру справочника Номенклатура с реквизитами и табличными частямиMCP
- Транспорт
- stdio, http, sse
- Авторизация
- API-ключ
Переменные окружения
MCP_ONEC_URLобязательная- URL базы 1С с опубликованным HTTP-сервисом.
MCP_ONEC_USERNAMEобязательная- Имя пользователя 1С, обязательно без OAuth2.
MCP_ONEC_PASSWORDобязательная, секрет- Пароль пользователя 1С, обязателен без OAuth2.
Ограничения
README прямо называет проект доработкой и адаптацией github.com/vladimir-kharin/1c_mcp под собственные задачи автора, поэтому часть архитектурных решений унаследована оттуда. Без OAuth2 все запросы идут от одного пользователя, указанного в конфигурации. Нужен опубликованный HTTP-сервис расширения 1С на стороне базы, инструкция по его установке в README отсутствует, есть только клиентская часть на Python. В README упомянут файл testMCP.md с результатами тестирования, но не описан состав автотестов подробно.
Как отключить. Остановите процесс python -m src.py_server и удалите сервер из конфигурации MCP-клиента.
Частые вопросы
Можно ли писать данные в 1С через этот сервер?
Нет, README описывает только инструменты чтения: список объектов метаданных, структура объекта и предопределенные элементы.
Обязателен ли OAuth2?
Нет, по умолчанию режим авторизации none и все запросы выполняются от одного пользователя из конфигурации.
Обсуждение
Вопросов и отзывов пока нет.
MCP-сервер метаданных 1С
1C_MCP_metadata
MCP-сервер поверх HTTP-сервиса расширения 1С: отдает структуру метаданных конфигурации, ищет объекты и проверяет синтаксис запросов
MCP-сервер OData 1С
1C OData MCP Server
Небольшой MCP-сервер на Python, который оборачивает стандартные операции чтения OData 1С:Управление предприятием в три инструмента
MCP-сервер OData 1С с JSON-кэшем
MCP сервер для работы с OData 1C
Python MCP-сервер поверх OData 1С: читает и меняет справочники и документы, сохраняет все данные в JSON-файлы для локального анализа без повторных запросов
MCP-сервер внутри 1С
1c_mcp
Расширение 1С, которое поднимает MCP-сервер прямо в базе: инструменты по метаданным из коробки и свои инструменты на BSL
1C MCP Server с прокси на FastAPI
1C MCP Server
Расширение 1С с HTTP-сервисом MCP плюс Python-прокси на FastAPI, который добавляет транспорт stdio, OAuth2 и Docker-запуск
Внешняя обработка 1С с MCP и REST API: запросы, метаданные, журнал регистрации и выполнение кода без изменения конфигурации
Коротко о README
README на русском объясняет назначение прокси-сервера между MCP-клиентами и HTTP-сервисом 1С, дает быстрый старт для stdio и HTTP режимов, документирует четыре API-метода с примерами JSON, таблицу параметров конфигурации, настройки OAuth2 с таймаутами токенов, схему архитектуры и раздел устранения неполадок. В начале и в конце указан исходный проект vladimir-kharin/1c_mcp, на основе которого сделана адаптация. Лицензия MIT.