MCP 服务器

superagenticmcp

Enables a production-grade MCP-native router and multi-agent control plane, letting agents plan tasks, route tool calls to the right MCP servers, stream every step, and persist results in memory.

README

SuperAgenticMCP

The switchboard for your agent swarm.

SuperAgenticMCP is a production-oriented, MCP-native router and multi-agent control plane. It sits between your agents and the MCP servers they need — planning the task, routing each tool call to the right server, streaming every step, and filing results into memory.

Patch every agent into every tool.

Support Agentic OS Kernels ($99) · Agentic OS Cycle ($0.75) · Public Goods Support · USDC

Layout standard: Server OS — see docs/LAYOUT.md.

Surfaces

Surface	Entry
Web control plane	`superagenticmcp.html` / `web/` (offline hero)
MCP Server	`superagenticmcp`
CLI	`superagenticmcp-cli status`
SDK	`from superagenticmcp.sdk import SuperAgenticClient`
Board (target)	`superagenticmcp up --board` → http://localhost:7420
Skills	`skills/*/SKILL.md`
AGENTS.md	Coding-agent contract
Verify	`bash scripts/verify.sh`
CI	`.github/workflows/ci.yml`

Why SuperAgenticMCP?

Problem	Approach
Agents need many MCP servers	One process racks servers and routes by capability
Tool calls are opaque	Live patch board + JSONL log + run receipt
Multi-agent coordination is ad-hoc	Built-in planner / worker / critic loop
Memory evaporates between runs	Memory scope constellation of artifacts
Config drifts from reality	Rack toggles generate `superagentic.json`

Features

Capability	Status
MCP over stdio (+ streamable HTTP planned)	✅ scaffold
Capability-first routing + latency tie-break	🚧 / demo in hero
Planner → parallel workers → critic	🚧 / demo in hero
Hot-swap server rack	🚧 / demo in hero
Live patch board + phosphor log	✅ hero
Memory scope (3D constellation)	✅ hero
Call budgets + offline skip	🚧
Dynamic `superagentic.json`	🚧
Server OS layout + verify contract	✅
Self-learning model routing (bandit)	🚧
Agentic commerce (x402)	🚧

Quick start

git clone https://github.com/ANAMIZED/SuperAgenticMCP
cd SuperAgenticMCP
python -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"

superagenticmcp                 # MCP server (stdio)
superagenticmcp-cli status
make test
bash scripts/verify.sh

Zero-install hero:

https://htmlpreview.github.io/?https://github.com/ANAMIZED/SuperAgenticMCP/blob/main/superagenticmcp.html

MCP client config

{
  "mcpServers": {
    "superagenticmcp": {
      "command": "superagenticmcp",
      "args": []
    }
  }
}

Docker (scaffold)

docker compose up --build

How routing works

Protocol — Model Context Protocol; one session per racked server.
Agent loop — Planner decomposes; workers run in parallel where allowed; critic checks before ship.
Routing — Capability match first, latency as tie-break, fallback when a server drops.
Guardrails — Per-server allow-lists and per-run call budgets.
Telemetry — JSONL lines + board replay.
Footprint — Single process for the core path; no DB required.

Repository layout

src/superagenticmcp/   # MCP, CLI, SDK
skills/                # Packaged skills (Server OS style)
web/                   # Control-plane path
scripts/verify.sh      # Verify contract
tests/                 # Smoke + contract tests
superagenticmcp.html   # Hero demo
docs/LAYOUT.md         # Permanent layout standard = Server OS
AGENTS.md              # Agent contract

Support

Fiat (Stripe)

Offer	Link
Support Agentic OS Kernels — $99	buy.stripe.com/…
Agentic OS Cycle — $0.75	buy.stripe.com/…
Public Goods Support	donate.stripe.com/…

GitHub Sponsors: ANAMIZED

USDC (crypto)

Non-custodial addresses controlled by ANAMIZED. Pure x402 micropayments preferred for agents — see x402-cloudflare-starter.

Network	Address	Explorer
Base	`0xD3d0E9eDAe3Ac7bb199a8EAA761BdA423b878438`	basescan
Ethereum	`0xD3d0E9eDAe3Ac7bb199a8EAA761BdA423b878438`	etherscan
Solana	`ETQwWf19axArsY493UfC6bxe2BmEzmzvCb58PPnC38A`	solscan