Core-MCP-Middleware
Спецификация JSON-RPC middleware между LLM-агентом и HTTP-сервисом 1С: протокол, аутентификация и решение проблемы порядка байт в UUID
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Спецификация описывает инструменты createDocument, updateDocument, deleteDocument, которые в реализации будут менять данные 1С
- Реализации нет, поэтому реальный риск зависит от того, как разработчик воплотит спецификацию
Установка
Ручная установка
Прочитай architecture.md и json_rpc_spec.md из репозитория kazancevaaroslava0-oss/core-mcp-middleware как справочный материал по протоколу и функции convert_uuid_to_1c_format, реализацию сервера нужно написать самостоятельно.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Репозиторий это документ проектирования, а не работающий код: описывает архитектуру 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 запроса?Ограничения
В репозитории нет ни строчки рабочего кода: только README, документ архитектуры с одним примером функции конвертации UUID и текстовая спецификация JSON-RPC методов. Нет ни сервера FastAPI, ни клиента, ни HTTP-сервиса 1С, ни тестов, ни релизов. Это черновик проектирования, а не устанавливаемый инструмент.
Как отключить. Ничего отключать не нужно: репозиторий не содержит работающего сервиса.
MCP
- Транспорт
- http
- Авторизация
- API-ключ
Проверка безопасности
- Спецификация описывает инструменты createDocument, updateDocument, deleteDocument, которые в реализации будут менять данные 1С
- Реализации нет, поэтому реальный риск зависит от того, как разработчик воплотит спецификацию
Коротко о README
Сам README это одна строка описания. Содержательная часть в architecture.md и json_rpc_spec.md: первый описывает компоненты системы (пользователь, LLM-агент, Python middleware, HTTP-сервис 1С), поток данных, требования безопасности (запрет прямых SQL-запросов, JWT, только HTTPS) и функцию конвертации UUID, второй дает полную спецификацию протокола JSON-RPC 2.0 с тремя методами и таблицей кодов ошибок. Лицензия указана в файле LICENSE.
Частые вопросы
Можно ли запустить этот middleware?
Нет, репозиторий содержит только документы проектирования: README, схему архитектуры и спецификацию JSON-RPC, рабочего кода нет.
В чем конкретная проблема с UUID?
1С хранит UUID в порядке байт Little-Endian, а Python и большинство LLM-инструментов используют Big-Endian, документ дает функцию конвертации первых трех групп UUID.
Похожие
Набор скиллов, который задает агенту процесс разработки: уточнение задачи, план, TDD, субагенты и ревью кода
Скиллы Мэтта Покока для инженеров
Skills For Real Engineers
Небольшие компонуемые скиллы для инженерной работы с агентом: интервью по плану, TDD, диагностика багов, ревью и архитектура
Набор GitHub для разработки от спецификации: CLI specify ставит в проект команды и скиллы для агента, от принципов до реализации
Референсные MCP-серверы
Model Context Protocol servers
Официальные референсные MCP-серверы: Filesystem, Fetch, Git, Memory, Sequential Thinking, Time и Everything