English Français العربية

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

السجل الرسمي مؤرشف الذكاء الاصطناعي والوكلاء

Exposes a CognOS agent system as a machine-readable graph. Full system snapshot with one tool call.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

PYPI package conductor-graph-mcp
Claude Code 
claude mcp add conductor-graph-mcp -e 'COGNOS_BASE_URL=<COGNOS_BASE_URL>' -e 'COGNOS_API_KEY=<your cognos_api_key>' -- uvx conductor-graph-mcp==0.1.1
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "conductor-graph-mcp": {
            "command": "uvx",
            "args": [
                "conductor-graph-mcp==0.1.1"
            ],
            "env": {
                "COGNOS_BASE_URL": "<COGNOS_BASE_URL>",
                "COGNOS_API_KEY": "<your cognos_api_key>"
            }
        }
    }
}

متغيرات البيئة

  • COGNOS_BASE_URL URL 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)

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Conductor Graph MCP Server
  2. Installation
  3. Usage with Claude Code
  4. Tools
  5. Known Node IDs
  6. Examples
  7. Node Status — Data Sources
  8. Environment Variables
  9. Verification
  10. License

Conductor Graph MCP Server

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

An MCP server that exposes a CognOS agent system as a machine-readable JSON graph. The conductor (Claude) calls a single tool and gets an immediate full system snapshot.

Built on the FNC architecture: Field (agents) → Node (processing) → Cockpit (oversight)

Installation

# 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 .

Usage with Claude Code

Add to ~/.claude/settings.json under 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"
      }
    }
  }
}

Or with 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"
      }
    }
  }
}

Restart Claude Code — the server activates automatically.

Note: Requires MCP SDK ≥ 1.0 (mcp on PyPI).

Tools

ToolDescription
get_agent_graphFull graph — nodes + edges + summary
get_node_status(node_id)Live status for a specific node
get_edgesOnly edges (communication flow)
get_blocked_nodesShortcut: what is broken right now?

Known Node IDs

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

Examples

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

Node Status — Data Sources

NodeSource
trustplane-gatewayHTTP 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 — is the process running?
conductorAlways active (the conductor itself)

Environment Variables

VariableDefaultDescription
COGNOS_BASE_URLhttp://127.0.0.1:8788TrustPlane gateway URL
COGNOS_API_KEY(empty)API key for gateway auth

Verification

# 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

License

MIT — Base76 Research Lab

الأسئلة الشائعة

ما هو io.github.base76-research-lab/conductor-graph-mcp؟

Exposes a CognOS agent system as a machine-readable graph. Full system snapshot with one tool call.

كيف أثبّت io.github.base76-research-lab/conductor-graph-mcp؟

يعمل على جهازك. في Claude Code: claude mcp add conductor-graph-mcp -e 'COGNOS_BASE_URL=<COGNOS_BASE_URL>' -e 'COGNOS_API_KEY=<your cognos_api_key>' -- uvx conductor-graph-mcp==0.1.1. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج io.github.base76-research-lab/conductor-graph-mcp إلى مفتاح API؟

نعم. يتطلب COGNOS_API_KEY، وتضبطها في إعداداته.

هل io.github.base76-research-lab/conductor-graph-mcp مفتوح المصدر؟

شيفرته علنية على GitHub، لكن المستودع لا يعلن ترخيصًا قياسيًا.

من يصون io.github.base76-research-lab/conductor-graph-mcp؟

ينشره base76-research-lab. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.