superagenticmcp

SuperAgenticMCP

エージェント群のためのスイッチボード。

SuperAgenticMCPは、本番環境を想定した、MCPネイティブのルーター兼マルチエージェント制御プレーンです。エージェントと必要なMCPサーバーの間に位置し、タスクを計画し、各ツール呼び出しを適切なサーバーに振り分け、すべてのステップをストリーミングし、結果をメモリに記録します。

すべてのエージェントを、あらゆるツールにつなぎます。

Agentic OS Kernels を支援する（$99） · Agentic OS Cycle（$0.75） · 公共財への支援 · USDC

レイアウト標準： Server OS — docs/LAYOUT.mdを参照してください。

---

インターフェース

インターフェース	エントリーポイント
Web制御プレーン	superagenticmcp.html / web/（オフラインのヒーローデモ）
MCP サーバー	superagenticmcp
CLI	superagenticmcp-cli status
SDK	from superagenticmcp.sdk import SuperAgenticClient
ボード（ターゲット）	superagenticmcp up --board → http://localhost:7420
スキル	skills/*/SKILL.md
AGENTS.md	コーディングエージェントの契約
検証	bash scripts/verify.sh
CI	.github/workflows/ci.yml

---

SuperAgenticMCPを選ぶ理由

課題	アプローチ
エージェントには多くのMCPサーバーが必要	1つのプロセスでサーバー群を集約し、機能に応じて振り分けます
ツール呼び出しの中身が見えない	ライブのパッチボード＋JSONLログ＋実行レシート
マルチエージェントの連携が場当たり的	プランナー／ワーカー／クリティックのループを標準搭載
実行のたびにメモリが消える	アーティファクトのメモリスコープ・コンステレーション
設定が実態と乖離する	ラックの切り替えでsuperagentic.jsonを生成します

---

機能

機能	ステータス
stdio経由のMCP（ストリーム可能なHTTPは予定）	✅ 足場
機能優先のルーティング＋レイテンシーによる同点判定	🚧 / ヒーローデモで実演
プランナー → 並列ワーカー → クリティック	🚧 / ヒーローデモで実演
サーバーラックのホットスワップ	🚧 / ヒーローデモで実演
ライブパッチボード＋蛍光体ログ	✅ ヒーロー
メモリスコープ（3Dコンステレーション）	✅ ヒーロー
呼び出し予算＋オフライン時のスキップ	🚧
動的なsuperagentic.json	🚧
Server OSレイアウト＋検証契約	✅
自己学習型モデルルーティング（バンディット）	🚧
エージェント型コマース（x402）	✅ x402-cloudflare-starterのGET /v1/cycle · /v1/search · /v1/draftにルーティング

コマース機能はここでは再実装していません。x402 Workerをラックに追加し、人間向けにはStripe Payment Linksを使い続けてください。レシートではDeskのロックは解除されません。

---

クイックスタート

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

インストール不要のヒーローデモ：

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

MCP クライアントの設定

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

Docker（足場）

docker compose up --build

---

ルーティングの仕組み

1. プロトコル — Model Context Protocol。ラックに設置されたサーバーごとにセッションを1つ使用します。
2. エージェントループ — プランナーがタスクを分解し、許可されている場合はワーカーが並列で実行します。出荷前にクリティックが確認します。
3. ルーティング — まず機能の一致で選び、同条件の場合はレイテンシで決定します。サーバーが停止した場合はフォールバックします。
4. ガードレール — サーバーごとの許可リストと、実行ごとの呼び出し予算を設定します。
5. テレメトリ — JSONL の行とボードのリプレイ。
6. フットプリント — コアパスは単一プロセスで動作し、データベースは不要です。

---

リポジトリの構成

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

---

サポート

法定通貨（Stripe）

提供内容	リンク
Agentic OS Kernels をサポート — $99	buy.stripe.com/…
Agentic OS Cycle — $0.75	buy.stripe.com/…
公共財へのサポート	donate.stripe.com/…

GitHub Sponsors： ANAMIZED

USDC（暗号資産）

ANAMIZED が管理する、カストディアルではないアドレスです。エージェントには純粋な x402 マイクロペイメントを推奨します。x402-cloudflare-starter をご覧ください。

ネットワーク	アドレス	エクスプローラー
Base	0xD3d0E9eDAe3Ac7bb199a8EAA761BdA423b878438	basescan
Ethereum	0xD3d0E9eDAe3Ac7bb199a8EAA761BdA423b878438	etherscan
Solana	ETQwWf19axArsY493UfC6bxe2BmEzmzvCb58PPnC38A	solscan

対応するネットワークで USDC のみを送金してください。異なる資産やチェーンを使用すると、取り戻せなくなる可能性があります。

---

関連プロジェクト

• server-os — レイアウト標準 · プロセスとしてのエージェント
• OpenGOS — 助成金と公共財の資金調達を扱う MCP
• LRSI — ローカル再帰型自己改善カーネル
• x402-cloudflare-starter — USDC マイクロペイメント（Base + Solana）

---

ライセンス

Apache-2.0

Model Context Protocol 向けに構築 · Unit 001 · SA-MCP MK.4 · Server OS レイアウト