conductor-graph-mcp

Conductor Graph MCP Server

mcp-name: io.github.base76-research-lab/conductor-graph-mcp

CognOS エージェントシステムを、機械で読み取り可能な JSON グラフとして公開する MCP サーバーです。指揮者（Claude）が単一のツールを呼び出すと、システム全体のスナップショットをすぐに取得できます。

FNC アーキテクチャに基づいています：Field（エージェント）→ Node（処理）→ Cockpit（監視）

---

インストール

# From PyPI (recommended)
pip install conductor-graph-mcp

# Or from source
git clone https://github.com/base76-research-lab/conductor-graph-mcp
cd conductor-graph-mcp
pip install -e .

Claude Code での使用方法

mcpServers の下にある ~/.claude/settings.json に追加します：

{
  "mcpServers": {
    "cognos-graph": {
      "command": "python3",
      "args": ["-m", "conductor_graph_mcp"],
      "env": {
        "COGNOS_BASE_URL": "http://127.0.0.1:8788",
        "COGNOS_API_KEY": "your-key"
      }
    }
  }
}

または、uvx を使用します：

{
  "mcpServers": {
    "cognos-graph": {
      "command": "uvx",
      "args": ["conductor-graph-mcp"],
      "env": {
        "COGNOS_BASE_URL": "http://127.0.0.1:8788",
        "COGNOS_API_KEY": "your-key"
      }
    }
  }
}

Claude Code を再起動すると、サーバーが自動的に有効になります。

注意： MCP SDK ≥ 1.0（PyPI の mcp）が必要です。

---

ツール

ツール	説明
get_agent_graph	グラフ全体 — ノード + エッジ + 概要
get_node_status(node_id)	特定のノードのライブステータス
get_edges	エッジのみ（通信フロー）
get_blocked_nodes	ショートカット：現在、何が壊れているか？

---

既知のノード ID

conductor
trustplane-gateway
token-compressor
session-memory
armada-bus
agent-critic
agent-curator
agent-ethics
agent-synth
agent-self
agent-srt
agent-indexer

---

例

get_agent_graph()                        # Full system overview
get_node_status("trustplane-gateway")    # One specific node
get_blocked_nodes()                      # What is broken?
get_edges()                              # Communication flow

---

ノードのステータス — データソース

ノード	ソース
trustplane-gateway	HTTP GET /healthz + /v1/providers/health
token-compressor	/tmp/b76_compress.log
session-memory	/tmp/b76_save.log + SQLite traces.sqlite3
armada-bus	/tmp/b76_armada_bus.json + /tmp/b76_armada_bus.log
agent-*	psutil — プロセスが実行中かどうか
conductor	常に active（指揮者自身）

---

環境変数

変数	デフォルト	説明
COGNOS_BASE_URL	http://127.0.0.1:8788	TrustPlane ゲートウェイの URL
COGNOS_API_KEY	(empty)	ゲートウェイ認証用 API キー

---

検証

# Test that the server starts
python3 -m conductor_graph_mcp

# Stop the gateway → trustplane-gateway.status = "error"
# get_blocked_nodes() should return trustplane-gateway

# Run a /save → session-memory.metrics.entries increases
# get_node_status("session-memory") shows new count

---

ライセンス

MIT — Base76 Research Lab