Skip to main content
Glama
base76-research-lab

Conductor Graph MCP Server

by base76-research-lab
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Local

Conductor Graph MCP Server

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

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 .

Related MCP server: byaml-mcp

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

Tool

Description

get_agent_graph

Full graph — nodes + edges + summary

get_node_status(node_id)

Live status for a specific node

get_edges

Only edges (communication flow)

get_blocked_nodes

Shortcut: 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

Node

Source

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 — is the process running?

conductor

Always active (the conductor itself)

Environment Variables

Variable

Default

Description

COGNOS_BASE_URL

http://127.0.0.1:8788

TrustPlane 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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • byaml-mcp

    breakingthecloud
    A
    license
    A
    quality
    C
    maintenance
    Enables AI agents to generate BYaML Architecture Graphs from evaluations, Terraform plans, and AWS scans, and to derive insights such as blast radius, cost summaries, and remediation plans without writing YAML.
    8
    Apache 2.0

  • archview

    LZZLHY
    A
    license
    Not graded
    quality
    B
    maintenance
    Provides agents with read-only access to local code architecture graphs (structure from tree-sitter, semantic summaries from LLMs), including per-workspace graph/config/status/rebuild tools, while enforcing that topology comes only from static analysis.
    3 npm
    MIT

  • GxP MDM MCP Server

    saram-io
    F
    license
    Not graded
    quality
    C
    maintenance
    Lets AI agents query a computerized system inventory as a knowledge graph using Cypher, enabling blast radius, data lineage, regulation checks, and change impact assessments while preventing hallucinated regulatory claims.
    -