@invariance/mcp

Сервер MCP (Model Context Protocol), который подключает ИИ-агентов для написания кода к платформе наблюдаемости Invariance. Он предоставляет таким инструментам, как Claude Desktop, Cursor и Claude Code, прямой доступ к вашим запускам (runs), узлам (nodes), мониторам, сигналам, результатам анализа (findings), проверкам (reviews) и многому другому.

MCP — это открытый протокол, позволяющий ИИ-ассистентам использовать внешние инструменты и источники данных. Этот сервер реализует его для Invariance, чтобы ваш ИИ-ассистент мог запрашивать данные наблюдаемости, расследовать проблемы и анализировать поведение агентов, не прерывая диалог.

Установка

npm install -g @invariance/mcp

Или запустите напрямую с помощью npx (рекомендуется для конфигураций клиентов MCP):

npx @invariance/mcp

Related MCP server: Claude Code Starter Kit MCP

Настройка

Переменные окружения

Получите свой API-ключ на странице app.invariance.ai/settings/api-keys.

Claude Desktop

Добавьте в конфигурацию Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json на macOS):

{
  "mcpServers": {
    "invariance": {
      "command": "npx",
      "args": ["-y", "@invariance/mcp"],
      "env": {
        "INVARIANCE_API_KEY": "your-api-key"
      }
    }
  }
}

Claude Code

Добавьте в конфигурацию Claude Code (.claude/settings.json или ~/.claude/settings.json):

{
  "mcpServers": {
    "invariance": {
      "command": "npx",
      "args": ["-y", "@invariance/mcp"],
      "env": {
        "INVARIANCE_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

Добавьте в настройки MCP для Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "invariance": {
      "command": "npx",
      "args": ["-y", "@invariance/mcp"],
      "env": {
        "INVARIANCE_API_KEY": "your-api-key"
      }
    }
  }
}

Доступные инструменты

Сервер предоставляет 37 инструментов, охватывающих весь API Invariance. Имена соответствуют шаблону invariance_<ресурс>_<действие>.

Запуски (Runs) (invariance_run_*) start, get, list, finish, fail, verify, metrics

Узлы (Nodes) (invariance_node_*) write, list

Мониторы (Monitors) (invariance_monitor_*) create, list, get, update, pause, resume, evaluate, executions, findings

Сигналы (Signals) (invariance_signal_*) emit, list, get, acknowledge, resolve

Результаты анализа (Findings) (invariance_finding_*) list, get, update

Проверки (Reviews) (invariance_review_*) list, get, claim, unclaim, resolve

Агенты (Agents) (invariance_agent_*) me, set_key

Аналитика (Insights) invariance_narrative_get (сводка запуска, синтезированная LLM), invariance_ask (вопросы и ответы по вашей базе знаний + запускам), invariance_kb_pages_list, invariance_kb_page_get

Для сложных аргументов объектов (тело монитора, данные сигнала, ввод/вывод узла, метаданные запуска) инструменты принимают JSON-строки, которые сервер парсит перед отправкой в API.

Устаревшие псевдонимы инструментов

Оригинальные 6 имен инструментов из ранних версий сохранены как псевдонимы, чтобы существующие конфигурации клиентов продолжали работать: invariance_create_run, invariance_get_run, invariance_list_runs, invariance_write_node, invariance_list_nodes, invariance_verify_run.

HTTP-транспорт

Чтобы запустить сервер через Streamable HTTP вместо stdio:

INVARIANCE_API_KEY=your-api-key INVARIANCE_MCP_TRANSPORT=http INVARIANCE_MCP_PORT=3000 npx @invariance/mcp

Сервер предоставляет Streamable HTTP-эндпоинт по адресу http://127.0.0.1:3000/mcp и проверку работоспособности (health check) по адресу http://127.0.0.1:3000/health.

Клиенты MCP, поддерживающие HTTP-транспорт, могут подключаться, используя URL эндпоинта /mcp вместо запуска подпроцесса.

Устранение неполадок

"INVARIANCE_API_KEY environment variable is required"

Убедитесь, что вы установили переменную окружения INVARIANCE_API_KEY в конфигурации вашего клиента MCP. См. руководства по настройке выше.

Сервер не отображается в вашем клиенте MCP

1. Проверьте правильность пути к файлу конфигурации для вашего клиента

2. Перезапустите клиент после редактирования конфигурации

3. Проверьте, что команда npx @invariance/mcp выполняется без ошибок в вашем терминале

Ошибки аутентификации

Проверьте, что ваш API-ключ действителен на странице app.invariance.ai/settings/api-keys.

Тайм-ауты соединения

Если вы используете пользовательский INVARIANCE_BASE_URL, проверьте, доступен ли этот URL.

Участие в разработке

См. CONTRIBUTING.md.

Лицензия

MIT