MCP Hook Conformance — MCP-сервер для Claude Code: что делает
Инструмент аудита MCP-серверов перед их вызовом в хуках Claude Code. Проверяет идемпотентность, задержки, детерминизм и побочные эффекты инструментов.
claude mcp add hook-conformance -- npx -y mcp-hook-conformanceЧто делает MCP Hook Conformance
Утилита тестирует поведение инструментов MCP, когда их запускают обработчики жизненного цикла Claude Code вроде PreCompact или Stop. Набор проверок оценивает пять критериев: повторяемость вывода без случайных меток времени, время ответа, стабильность структуры данных, отсутствие мутаций состояния и полноту описаний работы с данными.
Для поиска скрытых мутаций в конфигурации hook-conformance.config.json задаётся зонд stateProbe: без него тесты на побочные эффекты возвращают статус INDETERMINATE. Прогон выдаёт отчёт с кодами замечаний, а команда explain показывает пути исправления ошибок.
Какие задачи решает
- проверить идемпотентность MCP-инструментов перед подключением к хукам
- замерить сетевые задержки вызовов по квантилям p50 и p95
- обнаружить нежелательные мутации состояния в операциях чтения
- подготовить конфигурационный файл hook-conformance.config.json
Примеры запросов агенту
- Проверь готовность сервера к хукам через конфиг
./hook-conformance.config.json - Сгенерируй шаблон конфигурации для сервера
my-mcp-server - Объясни ошибку
IDEMP-001и подскажи способы исправления
Как установить MCP Hook Conformance
Командой платформы
claude mcp add hook-conformance -- npx -y mcp-hook-conformanceКомандой платформы
codex mcp add mcp-hook-conformance -- npx -y mcp-hook-conformanceФайл настроек
{
"mcpServers": {
"mcp-hook-conformance": {
"command": "npx",
"args": [
"-y",
"mcp-hook-conformance"
]
}
}
}Файл настроек
{
"servers": {
"mcp-hook-conformance": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-hook-conformance"
]
}
}
}Командой платформы
gemini mcp add mcp-hook-conformance npx -y mcp-hook-conformanceПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о MCP Hook Conformance
Как установить MCP Hook Conformance в Claude Code?
Выполните команду claude mcp add mcp-hook-conformance -- npx -y mcp-hook-conformance. Также можно запускать аудит напрямую через npx mcp-hook-conformance check ./hook-conformance.config.json.
Зачем нужен MCP Hook Conformance?
Пакет валидирует безопасность запуска сторонних MCP-серверов внутри хуков Claude Code, гарантируя стабильность ответов и предсказуемость задержек.
Что требуется для обнаружения побочных эффектов?
В файле настроек требуется объявить секцию stateProbe для чтения состояния. Если зонд не настроен, проверка завершится статусом INDETERMINATE.
