English Français العربية

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

Registre officiel Archivé IA et agents

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

Code source Documentation

Installation

Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « 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
Configuration 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>"
            }
        }
    }
}

Variables d'environnement

  • COGNOS_BASE_URL URL of the TrustPlane/CognOS gateway (default: http://127.0.0.1:8788)
  • COGNOS_API_KEY secret API key for the CognOS gateway (optional, leave empty if not required)

Documentation

Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.

Sommaire
  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

Questions fréquentes

Qu'est-ce que 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.

Comment installer io.github.base76-research-lab/conductor-graph-mcp ?

Il s'exécute sur votre machine. Dans 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. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.

Faut-il une clé API pour io.github.base76-research-lab/conductor-graph-mcp ?

Oui. Il attend COGNOS_API_KEY, à renseigner dans sa configuration.

io.github.base76-research-lab/conductor-graph-mcp est-il open source ?

Son code est public sur GitHub, mais le dépôt ne déclare pas de licence standard.

Qui maintient io.github.base76-research-lab/conductor-graph-mcp ?

Il est publié par base76-research-lab. AI.tn le référence sans le maintenir ni le recommander.

Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.