Core-MCP-Middleware
Спецификация JSON-RPC middleware между LLM-агентом и HTTP-сервисом 1С: протокол, аутентификация и решение проблемы порядка байт в UUID
- 0 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Спецификация описывает инструменты createDocument, updateDocument, deleteDocument, которые в реализации будут менять данные 1С
- Реализации нет, поэтому реальный риск зависит от того, как разработчик воплотит спецификацию
Установка
- Работает в
- Сервисы
Ручная установка
Прочитай architecture.md и json_rpc_spec.md из репозитория kazancevaaroslava0-oss/core-mcp-middleware как справочный материал по протоколу и функции convert_uuid_to_1c_format, реализацию сервера нужно написать самостоятельно.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Спецификация описывает инструменты createDocument, updateDocument, deleteDocument, которые в реализации будут менять данные 1С
- Реализации нет, поэтому реальный риск зависит от того, как разработчик воплотит спецификацию
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий это документ проектирования, а не работающий код: описывает архитектуру middleware на Python и FastAPI, которое должно принимать JSON-RPC 2.0 вызовы от LLM-агента, проверять JWT-аутентификацию и пересылать запросы в HTTP-сервис 1С. Отдельно разобрана конкретная проблема интеграции: 1С хранит UUID в порядке байт Little-Endian, а Python и большинство LLM-инструментов используют Big-Endian, и дан код функции конвертации. Спецификация json_rpc_spec.md описывает три метода: Auth для получения токена, GetMetadata для чтения метаданных объекта и ExecuteTool для вызова инструментов вроде createDocument, getDocument, updateDocument, deleteDocument и getCatalog, с примерами запросов, ответов и кодов ошибок.
Для кого. Для 1С-разработчиков, которые проектируют свой JSON-RPC мост между LLM-агентом и HTTP-сервисом 1С и хотят готовое решение для проблемы порядка байт UUID и пример протокола.
Подходит, если
- Нужен образец протокола JSON-RPC для интеграции агента с 1С с методами Auth, GetMetadata и ExecuteTool
- Нужно решить проблему порядка байт при передаче UUID между Python и 1С
- Нужен план архитектуры middleware, прежде чем писать свой код
Не подходит, если
- Нужен готовый к запуску сервер: в репозитории нет реализации, только документы проектирования
- Нужен HTTP-сервис 1С с методами Auth, GetMetadata, ExecuteTool: их описание есть только на стороне middleware, 1С-часть не приложена
Пример запроса к агенту
Как правильно конвертировать UUID из Python в формат 1С для JSON-RPC запроса?MCP
- Транспорт
- http
- Авторизация
- API-ключ
Ограничения
В репозитории нет ни строчки рабочего кода: только README, документ архитектуры с одним примером функции конвертации UUID и текстовая спецификация JSON-RPC методов. Нет ни сервера FastAPI, ни клиента, ни HTTP-сервиса 1С, ни тестов, ни релизов. Это черновик проектирования, а не устанавливаемый инструмент.
Как отключить. Ничего отключать не нужно: репозиторий не содержит работающего сервиса.
Частые вопросы
Можно ли запустить этот middleware?
Нет, репозиторий содержит только документы проектирования: README, схему архитектуры и спецификацию JSON-RPC, рабочего кода нет.
В чем конкретная проблема с UUID?
1С хранит UUID в порядке байт Little-Endian, а Python и большинство LLM-инструментов используют Big-Endian, документ дает функцию конвертации первых трех групп UUID.
Обсуждение
Вопросов и отзывов пока нет.
Внешняя обработка 1С с MCP и REST API: запросы, метаданные, журнал регистрации и выполнение кода без изменения конфигурации
MCP-сервер OData 1С с JSON-кэшем
MCP сервер для работы с OData 1C
Python MCP-сервер поверх OData 1С: читает и меняет справочники и документы, сохраняет все данные в JSON-файлы для локального анализа без повторных запросов
MCP-прокси к метаданным 1С (адаптация)
1C_MCP_SERVER_OWN
Python-прокси между MCP-клиентом и HTTP-сервисом 1С: читает метаданные, структуру объектов и предопределенные данные, с опциональным OAuth2
MCP-сервер внутри 1С
1c_mcp
Расширение 1С, которое поднимает MCP-сервер прямо в базе: инструменты по метаданным из коробки и свои инструменты на BSL
Нативный компонент, который поднимает полноценный MCP-сервер внутри 1С: инструменты, ресурсы, промпты пишутся на BSL, а протокол берет на себя DLL
MCP-сервер метаданных 1С
1C_MCP_metadata
MCP-сервер поверх HTTP-сервиса расширения 1С: отдает структуру метаданных конфигурации, ищет объекты и проверяет синтаксис запросов
Коротко о README
Сам README это одна строка описания. Содержательная часть в architecture.md и json_rpc_spec.md: первый описывает компоненты системы (пользователь, LLM-агент, Python middleware, HTTP-сервис 1С), поток данных, требования безопасности (запрет прямых SQL-запросов, JWT, только HTTPS) и функцию конвертации UUID, второй дает полную спецификацию протокола JSON-RPC 2.0 с тремя методами и таблицей кодов ошибок. Лицензия указана в файле LICENSE.