conductor-graph-mcp

Name: conductor-graph-mcp
Author: base76-research-lab

本地服务

github.com/base76-research-labAI 与智能体034 周前更新

代码仓库

关于 conductor-graph-mcp

conductor-graph-mcp 将 CognOS Agent 系统呈现为机器可读的 JSON 图，供 Claude 等协调器查看系统快照。它可查询节点状态、通信边和受阻节点。

主要功能

01获取完整 Agent 图
02查看指定节点实时状态
03查询通信关系边
04列出受阻节点

适用场景

01快速查看系统整体结构
02排查当前异常或受阻节点
03检查节点间通信流

MCP 相关

该 MCP 服务向 MCP 客户端提供图查询工具，包括完整图快照、节点状态、边和受阻节点信息。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "base76-research-lab-conductor-graph": {
      "command": "uvx",
      "args": [
        "conductor-graph-mcp"
      ],
      "env": {
        "COGNOS_BASE_URL": "<COGNOS_BASE_URL>",
        "COGNOS_API_KEY": "<COGNOS_API_KEY>"
      }
    }
  }
}

启动命令uvx conductor-graph-mcp

需要配置的环境变量

COGNOS_BASE_URLURL of the TrustPlane/CognOS gateway (default: http://127.0.0.1:8788)

COGNOS_API_KEY密钥API key for the CognOS gateway (optional, leave empty if not required)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

pypiconductor-graph-mcp0.1.1stdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Conductor Graph MCP 服务

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

一个将 CognOS Agent 系统作为机器可读 JSON 图公开的 MCP 服务。指挥者（Claude）调用单个工具，即可立即获取完整的系统快照。

基于 FNC 架构：Field（Agent）→ 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 中使用

在 ~/.claude/settings.json 的 mcpServers 下添加：

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