cluster-mcp

cluster

Robinhood Chain 上のエージェント型金融のためのランタイムレイヤーです。 AI 金融エージェントのセルフホスト可能なインデックスです。192 種類のトークン化株式とネイティブ暗号資産、実際の Uniswap v3 スワップ（非カストディアル）、永続メモリ、24 モデル対応の LLM ゲートウェイを備えています。

npx @clusteragent/cluster-mcp

npx skills add clusteragent/cluster        # any skills-CLI agent
pip install cluster-agent                  # Python SDK

リポジトリ構成

├── SKILL.md                    main installer skill (any agent)
├── index.mjs                   MCP server — 35 tools (@clusteragent/cluster-mcp)
├── skills/
│   ├── swap/                   dedicated swap execution: safety scan → quote →
│   │                           calldata → sign → receipt proof, DCA/bracket patterns
│   ├── trading/                quotes, market data, chart (4663)
│   ├── memory/                 built-in memory + Hindsight backend
│   ├── finance/                portfolio, payouts, keys & metering
│   ├── crypto-intel/           wallet forensics, pool forensics, scout swarm
│   ├── research/               agent roster + OpenBB integration
│   ├── llm-gateway/            24 models, thinking mode, credit accounting
│   ├── portfolio/              wallet valuation, DCA/TP-SL previews
│   ├── social/                 X links + tip intents
│   └── monitor/                price/wallet/cycle/gas watch loops
├── python/                     cluster-agent PyPI SDK
└── docs/self-hosting.md        deployment guide

スキルは合計 11 個です。インストーラー 1 個と、ドメイン別サブスキル 10 個です。

cluster のバックエンド、フロントエンド、キーパーボットはこのリポジトリに含まれていません。ボットが実際の財務トランザクションに署名するため、運用スタックは非公開にしています。このリポジトリはスキル／MCP プラットフォームです。任意の cluster デプロイを指定して使用できます。

クイックスタート

エージェントを使用する方は、SKILL.md をご覧ください。MCP の設定：

{ "mcpServers": { "cluster": {
    "command": "npx", "args": ["-y", "@clusteragent/cluster-mcp"],
    "env": { "CLUSTER_API_URL": "https://clusteragent.dev", "CLUSTER_API_KEY": "clst_...", "CLUSTER_WALLET": "0x..." }
}}}

セルフホストする方は、docs/self-hosting.md をご覧ください。Docker イメージとデプロイガイドを用意しています。デフォルトは SQLite で、チャット用の LLM キー 1 つを除き、外部サービスは不要です。

Python については、python/ をご覧ください：

from cluster import Cluster
c = Cluster(api_url="https://your-host", api_key="clst_...")
c.quotes(["NVDA", "PONS"]); c.payout_basket(); c.chat("hi", thinking=True)

仕組み

fees in ──▶ vault ──▶ keeper bot buys the 19-name basket ──▶ $CLST holders paid pro-rata

保有することがポジションです。すべてのサイクルは公開されています：GET /api/distributions。

インテグレーション

プロジェクト	役割	ガイド
Hindsight	学習メモリのバックエンド（観察、メンタルモデル）	skills/memory/
OpenBB	MCP／Python 経由の機関投資家向け市場データ（ファンダメンタルズ、マクロ）	skills/research/
Maybe	セルフホスト可能な個人向け金融 UI（AGPLv3 — フォーク名を変更してください）	skills/finance/
OpenCatz	4663 上のマルチエージェント・スカウトスウォームパターン	skills/crypto-intel/
Uniswap AI	このリポジトリが採用するスキルアーキテクチャ	構造

エージェント

取引 Relay · Pivot — 調査 Scout · Sifter · Quill — 分析 Argus · Prism · Census — 金融 Ledger · Remit · Margin — メモリ Memoria · Echo — 暗号資産 Nexus · Vault · Oracle

設計段階から誠実さを徹底

• ローンチ前の配当データは、捏造せず正直にゼロとします
• スワップ：API が見積もりを提示し、署名するのはお客様のウォレットです。サーバー側に秘密鍵はありません
• キー：保存時は SHA-256 でハッシュ化され、一度だけ表示されます
• 見積もりは予測、レシートは証明です（Transfer ログを解析してください）

ライセンス

MIT。バックエンドとスキルは独自に開発したものです。Maybe Finance のフォークに関する注意事項は、そのインテグレーションをセルフホストする場合に適用されます（AGPLv3、商標に関する規則は skills/finance/ をご覧ください）。