@invariance/mcp

AIコーディングエージェントをInvarianceオブザーバビリティプラットフォームに接続するMCP（Model Context Protocol）サーバーです。Claude Desktop、Cursor、Claude Codeなどのツールから、実行（runs）、ノード、モニター、シグナル、調査結果（findings）、レビューなどに直接アクセスできるようになります。

MCPは、AIアシスタントが外部ツールやデータソースを利用できるようにするためのオープンプロトコルです。このサーバーはInvariance向けに実装されており、AIアシスタントが会話を中断することなく、オブザーバビリティデータのクエリ、問題の調査、エージェントの動作分析を行えるようにします。

インストール

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の設定（macOSの場合は ~/Library/Application Support/Claude/claude_desktop_config.json）に追加します：

{
  "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

CursorのMCP設定（.cursor/mcp.json）に追加します：

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

利用可能なツール

このサーバーは、Invariance API全体をカバーする37個のツールを公開しています。名前は invariance_<resource>_<action> に従います。

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（ナレッジベースと実行データに対するターンベースのQ&A）、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トランスポート

stdioの代わりにStreamable HTTP経由でサーバーを実行するには：

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

サーバーは http://127.0.0.1:3000/mcp にStreamable HTTPエンドポイントを、http://127.0.0.1:3000/health にヘルスチェックエンドポイントを公開します。

HTTPトランスポートをサポートするMCPクライアントは、サブプロセスを起動する代わりに /mcp エンドポイントURLを使用して接続できます。

トラブルシューティング

"INVARIANCE_API_KEY environment variable is required"

MCPクライアントの設定で INVARIANCE_API_KEY 環境変数が設定されていることを確認してください。上記のセットアップガイドを参照してください。

MCPクライアントにサーバーが表示されない

1. クライアントの設定ファイルのパスが正しいか確認してください

2. 設定を編集した後、クライアントを再起動してください

3. ターミナルで npx @invariance/mcp がエラーなく実行できるか確認してください

認証エラー

app.invariance.ai/settings/api-keys でAPIキーが有効であることを確認してください。

接続タイムアウト

カスタムの INVARIANCE_BASE_URL を使用している場合は、そのURLに到達可能であることを確認してください。

コントリビューション

CONTRIBUTING.md を参照してください。

ライセンス

MIT