odgs-mcp-server — MCP-сервер для Claude Code
Подключает ИИ-агента к движку ODGS: проверяет данные по правилам управления, считает зрелость и выдаёт подписанные S-Certs.
claude mcp add --env ODGS_PROJECT_ROOT=<ODGS_PROJECT_ROOT> --env ODGS_API_KEY=<ODGS_API_KEY> --transport stdio odgs-mcp-server -- uvx odgs-mcp-serverЧто делает odgs-mcp-server
Сервер работает через stdio, поэтому подходит любому MCP-клиенту. В бесплатном наборе — validate_payload, validate_batch, list_packs, governance_score и conformance_check: агент проверяет полезную нагрузку по правилам ODGS и получает на каждую проверку подписанный S-Cert.
governance_score считает зрелость по восьми столпам ISO/IEC 38505-1 и ISO/IEC 25012 и выдаёт оценку от 0 до 100 с разбором пробелов. Если пакет odgs-maturity не установлен, оценка идёт по встроенной эвристике — это повод поставить его сразу.
Компиляция регламентов, поиск смыслового дрейфа, обнаружение конфликтов и сбор правил из Databricks, Snowflake и Collibra открываются только с лицензией Certified Pack. Для них нужен ключ в ODGS_API_KEY; без него доступна лишь community-часть. Путь к проекту задаётся в ODGS_PROJECT_ROOT.
Какие задачи решает
- проверить набор данных по правилам управления и получить подписанный S-Cert
- оценить зрелость проекта по восьми столпам ISO и увидеть пробелы
- прогнать сразу несколько наборов данных одной командой
- выполнить самопроверку соответствия ODGS уровня L1 или L2
- превратить текст регламента в валидный ODGS-правило JSON по лицензии
Примеры запросов агенту
- Проверь этот набор данных через
validate_payloadи покажи S-Cert - Посчитай
governance_scoreдля проекта и разбери пробелы по столпам - Скомпилируй текст регламента в ODGS-правила через
compile_regulation
Как установить odgs-mcp-server
Командой платформы
claude mcp add --env ODGS_PROJECT_ROOT=<ODGS_PROJECT_ROOT> --env ODGS_API_KEY=<ODGS_API_KEY> --transport stdio odgs-mcp-server -- uvx odgs-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from odgs-mcp-server <команда>
Командой платформы
codex mcp add odgs-mcp-server --env ODGS_PROJECT_ROOT=<ODGS_PROJECT_ROOT> --env ODGS_API_KEY=<ODGS_API_KEY> -- uvx odgs-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from odgs-mcp-server <команда>
Файл настроек
{
"mcpServers": {
"odgs-mcp-server": {
"command": "uvx",
"args": [
"odgs-mcp-server"
],
"env": {
"ODGS_PROJECT_ROOT": "<ODGS_PROJECT_ROOT>",
"ODGS_API_KEY": "<ODGS_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from odgs-mcp-server <команда>
Файл настроек
{
"servers": {
"odgs-mcp-server": {
"type": "stdio",
"command": "uvx",
"args": [
"odgs-mcp-server"
],
"env": {
"ODGS_PROJECT_ROOT": "<ODGS_PROJECT_ROOT>",
"ODGS_API_KEY": "<ODGS_API_KEY>"
}
}
}
}Вместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from odgs-mcp-server <команда>
Командой платформы
gemini mcp add -e ODGS_PROJECT_ROOT=<ODGS_PROJECT_ROOT> -e ODGS_API_KEY=<ODGS_API_KEY> odgs-mcp-server uvx odgs-mcp-serverВместо <…> подставьте свои значения. uvx запускает команду с именем пакета; если в README она другая — uvx --from odgs-mcp-server <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о odgs-mcp-server
Как установить odgs-mcp-server в Claude Code?
Одной командой: claude mcp add odgs-mcp-server -e ODGS_API_KEY=<ODGS_API_KEY> -- uvx odgs-mcp-server. Если нужен путь к проекту, используйте вторую форму: `claude mcp add --env ODGS_PROJECT_ROOT=<ODGS_PROJECT_ROOT> --env ODGS_API_KEY=<ODGS_API_KEY> --transport stdio odgs-mcp-server -- uvx odgs-mcp-server`.
Что делает odgs-mcp-server?
Соединяет ИИ-агента с движком ODGS: проверяет данные по правилам управления, считает зрелость и выпускает подписанные S-Certs для аудита.
Обязателен ли ключ API?
Нет, для проверки данных, оценки зрелости и самопроверки ключ не нужен. Компиляция регламентов, дрейф, конфликты и синхронизация каталогов требуют лицензии Certified Pack и ODGS_API_KEY.
