Интеллектуальная MCP-платформа нормативных требований автопроизводителей (regs-mcp)

Предоставляет интеллектуальные возможности для работы с отечественными и зарубежными автомобильными нормами и стандартами: поиск, сравнение, прослеживаемость, ответы на вопросы с указанием источников и вызов из корпоративных систем — в виде MCP-сервиса.

Возможности

• Интеллектуальное ядро обработки нормативов/положений: поиск, ответы с указанием источника, сравнение (планируется).

• Обязательное указание источника: любой вывод о соответствии должен содержать номер стандарта, номер пункта и выдержку из оригинала; вывод без источника автоматически понижается до unknown и помечается как требующий ручной проверки.

• Единый протокол: MCP 2026-07-28 + Streamable HTTP; Java-платформа и 飞书 могут напрямую вызывать сервис в роли MCP-клиентов, без отдельной адаптации для каждой стороны.

• Сравнение нормативов: сравнение отечественных и зарубежных норм, действующих стандартов и проектов для обсуждения, экспорт в редактируемый Excel (планируется).

Related MCP server: spec-assistant

Архитектура

src/regs_mcp/
├── core/        领域模型与引用强制规则（不依赖 MCP/LLM/DB）
├── retrieval/   数据持久化与混合检索（SQLite + 纯 Python 打分，零外部依赖）
├── llm/         OpenAI 兼容 LLM 客户端 + 离线 mock 兜底
├── qa/          问答管线（检索→草稿→引用校验→结构化）
├── ingest/      种子数据加载
├── mcp/         MCP 适配层（regs-knowledge 智能核）
├── feishu/      飞书适配器（规划）
└── eval/        评测集 + 指标

Принципы архитектуры

• Инверсия зависимостей (DIP): доменный/прикладной слой определяет только порты; поиск, LLM, экспорт и другие возможности внедряются инфраструктурным слоем через сменные реализации; переход на открытые компоненты или собственные разработки не влияет на базовую логику.

• Приоритет стандартных протоколов: MCP 2026-07-28 + Streamable HTTP, вызывающей стороне не требуется отдельная адаптация.

• Расширяемость: инструменты разделяются по правилу «на каждый server ≤ 8 tool»; поисковики, модели и форматы экспорта регистрируются в виде стратегий/плагинов; добавление нового источника данных или формата экспорта не меняет ядро.

• Прагматичное использование открытых компонентов: парсинг (MinerU/Docling), векторные базы данных, SDK для 飞书 и т.п. — всё подключаемо; протокольный слой зависит только от официального MCP SDK, исключая привязку к одному продукту.

Запуск

cd vehicle-regs-mcp
python -m venv .venv && . .venv/Scripts/activate
pip install -e ".[dev]"

# 灌入种子数据
PYTHONPATH=src python -c "from regs_mcp.ingest.loader import load_seed; \
from regs_mcp.retrieval.store import RegulationStore; \
s=RegulationStore('data/regs.db'); print(load_seed(s, 'data/seed'))"

# 评测（离线可跑，无需任何 API key）
PYTHONPATH=src python -m regs_mcp.eval.run

# 测试
pytest

# 启动 MCP 服务（Streamable HTTP）
PYTHONPATH=src python -m regs_mcp.mcp.server

Подключение большой языковой модели (опционально)

По умолчанию используется офлайн mock (экстрактивный синтез), что позволяет демонстрировать работу где угодно. Подключение локальной или облачной большой модели:

export REGS_LLM_BASE_URL=http://<endpoint>/v1
export REGS_LLM_API_KEY=<token>
export REGS_LLM_MODEL=<model>
export REGS_LLM_MOCK=0

Оценка

20 реальных бизнес-задач: полнота цитирования 100%, точность нахождения пунктов 95%.

Дорожная карта

• M1 (завершено): интеллектуальное ядро regs-knowledge (поиск + ответы с указанием источника + оценочный набор).

• M2: regs-graph (обратный поиск по деталям/функциям, анализ воздействия) + compare (сравнение отечественных и зарубежных норм, действующих стандартов и проектов для обсуждения, экспорт в Excel).

• M3: regs-jobs (разбор и загрузка в базу) + адаптер бота 飞书 (подписка на события → вызов MCP → карточки с форматированным текстом).

Лицензия

MIT