schema-mcp-core

Основа для MCP-серверов над российскими деловыми API. Сам по себе ничего не подключает: сервер приносит каталог методов (endpoints.yaml) и тонкий server.py, всё остальное берёт отсюда.

Так устроены hh-mcp-ru, diadoc-mcp-ru, sbis-mcp-ru, chestny-znak-mcp-ru и vk-mcp-ru.

Что внутри

Зачем отдельный пакет

Ядро это 2 200 строк, а сервер поверх него 66. Пять серверов, живущих отдельными репозиториями, иначе несли бы пять копий одного кода, и правка безопасности в одном месте оставляла бы четыре непочиненных.

Минимальный сервер

from mcp.server.fastmcp import FastMCP
from schema_mcp_core.client import MarketplaceClient, ServiceConfig
from schema_mcp_core.registry import Catalog
from schema_mcp_core.tools import register_generic_tools

catalog = Catalog.from_yaml(Path(__file__).parent / "endpoints.yaml")
config = ServiceConfig(service="hh", base_url="https://api.hh.ru", ...)
mcp = FastMCP("hh-mcp-ru")
register_generic_tools(mcp, prefix="hh", catalog=catalog, client_factory=...)

Живой пример с авторизацией и кабинетами лежит в любом из пяти серверов выше.

Что ядро НЕ делает

Не ходит в сеть само, не хранит ключи в репозитории, не пишет в сервис без подтверждения: методы класса write и destructive требуют явного согласия на стороне вызова.

Установка

pip install schema-mcp-core

Кто это сделал

Илья Утов, лаборатория AI Frontier. На этом ядре собраны business-mcp-ru и пять его серверов: hh.ru, VK, Диадок, СБИС, Честный знак.

Остальные проекты одним списком, разобранные по назначению: ilyautov.github.io.

MIT.