cambrian-api

Cambrian API MCP

Cambrian API 用の Model Context Protocol サーバーです。ライブの DeFi、ソーシャルインテリジェンス、リスク、API ドキュメントのツールを必要とするエージェントに、cambrian CLI と同じ製品機能を提供します。

すべての呼び出しで、呼び出し元が Cambrian API キーを指定する必要があります。ホスト型サーバーとローカルパッケージのどちらにもキーが必要です。サーバーが共有キーを配布したり、プロキシしたりすることはありません。 https://console.cambrian.org/ でキーを作成してください。API キーなしで x402 の従量課金アクセスを利用するには、 cambrian pay --help を使用してください。MCP トランスポートでは、引き続き呼び出し元がキーを指定する必要があります。

利用できる機能

• Cambrian API の各公開エンドポイントに対応する簡潔なツールを 1 つずつ備えた、段階的なデフォルトプロファイル
• ツールの読み込み方法が異なるクライアント向けの、コンパクトプロファイルとフルプロファイル
• Solana トークンのスナップショットを取得する複合ワークフローツール
• https://docs.cambrian.org/llms.txt から最新のエンドポイントおよびガイドのドキュメントを取得する cambrian_docs
• ローカル MCP クライアント向けの stdio トランスポート
• ホスト型およびセルフホスト型デプロイ向けの Streamable HTTP トランスポート

ツールプロファイル

プロファイル	stdio	HTTP	ツールメタデータ
Progressive（デフォルト）	フラグなし、または --profile progressive	/mcp	型、必須フィールド、スカラーの列挙値、OpenAPI のデフォルト値、数値の範囲、配列項目の型を含む、エンドポイントを直接呼び出すツールです。
Compact	--profile compact	/mcp/compact	cambrian_docs、cambrian_call、cambrian_solana_token_snapshot の 3 つのツールです。
Full	--profile full	/mcp/full	リクエストの完全な説明、デフォルト値、制約、レスポンスサイズの制御機能を含む、エンドポイントを直接呼び出すツールです。

すべてのプロファイルで、同じ段階的なドキュメント取得フローを使用します。デフォルトでは、cambrian_docs はリクエストスキーマを返します。レスポンスフィールドを確認するには、detail を response に設定してください。レスポンスビューにはリクエストスキーマも含まれます。例とすべてのエンドポイントの説明を確認する場合に限り、detail を full に設定してください。フルプロファイルは、すべてのエンドポイントのレスポンスドキュメントを事前に読み込みません。

Progressive では、重複するエンドポイントの説明、長いパターン、大きな配列の列挙値、パラメーターの説明を省略します。これらの詳細は cambrian_docs を呼び出して確認してください。

Progressive では offset、order_asc、order_desc も省略します。これらは、対応するすべてのエンドポイントで共通です。さらに Progressive では、エンドポイントごとのソート可能な列の列挙値もすでに省略しているため、これらを繰り返してもツールリストが約 10 kB 増えるだけで、エージェントに新たな情報は伝わりません。サーバーの指示ではこれらのパラメーターを一度だけ示しますが、すべてのエンドポイントで引き続き利用できます。limit は、エージェントがレスポンスの範囲を制限する方法であるため、最大値とともに残します。

ツールセット

カタログ全体には 159 個のツールがあります。Solana についてのみ質問するエージェントでも、呼び出すことのない 116 個の EVM ツールの分まで負担することになります。必要なものだけを読み込むには、--toolsets を使用してください。

ツールセット	ツール
solana	cambrian_solana_* と Solana トークンのスナップショット
evm	cambrian_base_*、cambrian_ethereum_*、cambrian_arbitrum_*、cambrian_robinhood_*
deep42	cambrian_deep42_*
risk	cambrian_risk_*

npx -y cambrian-api-mcp --toolsets solana,risk
CAMBRIAN_TOOLSETS=solana npx -y cambrian-api-mcp

HTTP では、リクエストごとに選択します：https://mcp.cambrian.org/mcp?toolsets=solana。

このオプションを省略するか、all を指定すると、すべてのツールを取得できます。cambrian_docs は常に含まれるため、対象を絞ったクライアントでも任意のエンドポイントを見つけて、その詳細を確認できます。

Progressive の tools/list サイズ：

選択	ツール	バイト数
デフォルト（すべて）	159	39,571
evm	117	28,158
solana	37	10,904
deep42	6	3,663
risk	2	2,093

MCP クライアントによるツールの読み込み

MCP クライアントは、選択したプロファイルの tools/list の結果全体を受け取ります。MCP は、その結果のどの程度がモデルのコンテキストに含まれるかを制御しません。

Claude Code は通常、最初にツール名とサーバーの指示を読み込みます。Tool Search の後、選択したツールの定義全体を読み込みます。Tool Search 機能を利用できる場合、Codex も同じように動作します。ほかのクライアントでは、すべてのツール定義を最初に読み込むことがあります。

クライアントは、選択したプロファイルから定義を読み込みます。Progressive によって省略されたフィールドを復元することはありません。完全なリクエストスキーマ、レスポンスフィールド、例を読み込むには、cambrian_docs を使用してください。

エージェントスキル

初めて利用する方とエージェントのランタイムは、こちらから始めてください：skills/cambrian-mcp/SKILL.md。Cambrian API キー認証、ホスト型およびローカルのクライアント設定、ツールの命名規則、cambrian_docs による検索、複合ツール、レスポンスの制限、エラー処理を、1 つのドキュメントで説明しています。

MCP ではなく CLI を使用する場合は、cambrian CLI スキルをご覧ください。

CLI での推奨セットアップ

cambrian CLI は、そのまま使える MCP クライアント設定を表示してテストします：

npm install -g cambrian
cambrian mcp config --mode hosted
cambrian mcp config --mode local
cambrian mcp install --client claude --mode hosted
cambrian mcp test --mode hosted

ローカル stdio

公開済みのパッケージを直接実行します：

export CAMBRIAN_API_KEY=<your-api-key>
npx -y cambrian-api-mcp

MCP クライアントで別のプロファイルが必要な場合にのみ、別のプロファイルを選択してください：

npx -y cambrian-api-mcp --profile compact
npx -y cambrian-api-mcp --profile full

必要なツールセットにカタログを絞り込みます：

npx -y cambrian-api-mcp --toolsets solana,risk

または、グローバルにインストールします：

npm install -g cambrian-api-mcp
export CAMBRIAN_API_KEY=<your-api-key>
cambrian-api-mcp

ホスト型 Streamable HTTP

CLI を使用して、現在のホスト型 URL とクライアント固有の設定を表示します：

cambrian mcp config --mode hosted

Claude の直接設定：

claude mcp add --transport http cambrian \
  https://mcp.cambrian.org/mcp \
  --header "Authorization: Bearer YOUR_CAMBRIAN_API_KEY"

Codex の設定には TOML を使用します：

[mcp_servers.cambrian]
url = "https://mcp.cambrian.org/mcp"
bearer_token_env_var = "CAMBRIAN_API_KEY"

デフォルトの URL では progressive プロファイルが使用されます。別のプロファイルには https://mcp.cambrian.org/mcp/compact または https://mcp.cambrian.org/mcp/full を使用してください。

HTTP リクエストには、次のいずれかを含める必要があります：

Authorization: Bearer <CAMBRIAN_API_KEY>
X-Cambrian-Api-Key: <CAMBRIAN_API_KEY>

セルフホスト型 HTTP

npm install
npm run build
node dist/index.js --transport http --host 127.0.0.1 --port 8080

ヘルスエンドポイント：

curl http://127.0.0.1:8080/health

ホスト型デプロイでは、0.0.0.0 にバインドしてください：

node dist/index.js --transport http --host 0.0.0.0 --port 8080

ツール名

ツール名は正規の名前で、cambrian_ が接頭辞に付いています。

例：

• cambrian_base_dexes
• cambrian_ethereum_dexes
• cambrian_arbitrum_dexes
• cambrian_robinhood_dexes
• cambrian_solana_price_current
• cambrian_deep42_social_data_alpha_tweet_detection
• cambrian_risk_perp_risk_engine
• cambrian_docs
• cambrian_solana_token_snapshot

パスを指定せずに cambrian_docs を呼び出すと、現在のルートインデックスを確認できます。また、そこに記載されているガイドには guides/<slug>（例：guides/x402）を使います。エンドポイントのパスでは、リクエストスキーマを取得するために detail を省略します。レスポンスのフィールドには detail: "response" を、例とエンドポイントに関するすべての説明には detail: "full" を使います。

エンドポイントツールは、CLI と同じ検証済みランタイムレジストリから取得されます。MCP はツール一覧の取得およびツール呼び出しのリクエストごとにローカルキャッシュを再確認します。一方、OpenAPI へのネットワークアクセスはまとめて処理され、ソースごとに 15 分に 1 回までに制限されます。ランタイムの検出を利用できない場合、サーバーはインストール済みの cambrian パッケージにバンドルされたエンドポイントメタデータ（cambrian/metadata）を使用します。ツール名、スキーマ、引数の検証は cambrian/tools から取得されるため、各ツールは対応する cambrian CLI コマンドと同じリクエストを送信します。

API は、chain_id パラメーターで各エンドポイントがサポートするチェーンを指定する、単一の汎用 /api/v1/evm/* インターフェースを提供します。MCP はこれを、サポート対象の各チェーン専用の固定チェーンツールに変換します。そのため、エージェントがマジックナンバーを覚える必要はなく、エンドポイントに拒否されるチェーンを指定することもありません。

チェーン	ID	ツールの接頭辞
Base	8453	cambrian_base_*
Ethereum	1	cambrian_ethereum_*
Arbitrum	42161	cambrian_arbitrum_*
Robinhood Chain	4663	cambrian_robinhood_*

チェーン用のツールは、そのエンドポイント独自の chain_id スキーマで当該チェーンが許可されている場合に限り表示されます。許可条件は、enum、固定された minimum／maximum の組み合わせ、または排他的な境界値から判断されます。許可リストやエンドポイントごとの特例はありません。API がエンドポイントの対応範囲に別の登録済みチェーン ID を追加すれば、次回のメタデータ読み込み時にそのチェーンのツールが追加されます。Base のツールでは chain_id が 8453、Ethereum では 1、Arbitrum では 42161、Robinhood では 4663 に固定されます。

cambrian_docs は、EVM パスのチェーン部分を ID またはスラッグで任意指定できます。evm/42161/dexes、evm/arbitrum/dexes、evm/dexes はすべて同じエンドポイントに解決され、チェーンを指定した形式では、そのチェーンに固定されたスキーマが返されます。Robinhood のパスでは evm/4663/dexes と evm/robinhood/dexes も使用できます。

チェーンの一覧は cambrian CLI（cambrian/tools 内の EVM_CHAINS）から取得されます。src/server.ts が追加するのは cambrian_docs のパスエイリアスのみです。チェーンを追加するには、CLI に追加して CLI をリリースし、ここで cambrian を更新します。

開発

npm ci
npm test
npm run build
npm pack --dry-run

このパッケージは、共有メタデータと API クライアントのために公開済みの cambrian パッケージに依存しています。両方のパッケージを同時に変更する場合は、先に cambrian を公開してから、このパッケージのロックファイルを更新し、CI/CD を通じて MCP サーバーをデプロイしてください。

デプロイ

デプロイは、プライベートなソースリポジトリから GitHub Actions と Cloud Run によって実行されます。手動でデプロイしないでください。

ワークフロー：

1. 依存関係をインストールします
2. package.json#mcpName が server.json#name と一致することを検証します
3. package.json#version が server.json#version と一致することを検証します
4. ビルドしてテストします
5. Docker イメージをビルドします
6. Cloud Run にデプロイします
7. ステージング環境を直接スモークテストします。本番環境は DNS と証明書が有効になった後、公開エッジ URL 経由でスモークテストします

レジストリ

公式 MCP Registry では、このサーバーは次の名前で公開されています。

io.github.cambriannetwork/cambrian-api

マニフェストでは https://mcp.cambrian.org/mcp を使用します。これは本番のエッジ URL と一致します。公開リリースワークフローでは、npm への公開後に新しい Registry バージョンが公開されます。