three.ws Brain

@three-ws/brain-mcp

あらゆるモデルを、ひとつのインターフェースで — three.ws のマルチプロバイダールーターを通じて LLM プロバイダーを検出し、あらゆる AI エージェントからチャット補完を実行できます。

---

あらゆる AI アシスタントに stdio 経由で three.ws のマルチプロバイダー LLM ルーターを提供する、Model Context Protocol サーバーです。利用可能なモデル — Claude、GPT-5.6 ファミリー、o3、Grok、Qwen、DeepSeek、NVIDIA Nemotron、IBM Granite など — を検出し、各ベンダーの SDK を個別に組み込まずに、用途に合ったモデルでチャット補完を実行できます。

このルーターはすべてのプロバイダーを単一のエンドポイントの背後に配置し、選択したモデルが一時的に停止している場合は、ミラーや無料ティアに透過的にフォールバックします。無料のオープンウェイトティア（GPT-OSS 120B、NVIDIA NIM モデル）はキー不要で利用でき、有料のファーストパーティ最上位モデルは three.ws API キーで利用できます。

インストール

npm install @three-ws/brain-mcp

インストールせずに npx で実行することもできます。

npx @three-ws/brain-mcp

クイックスタート

Claude Code の場合は、次の 1 行を実行します。

claude mcp add brain -- npx -y @three-ws/brain-mcp

有料の最上位モデルを利用するには、three.ws API キーを渡します。

claude mcp add brain -e THREE_WS_API_KEY=sk_live_… -- npx -y @three-ws/brain-mcp

Claude Desktop / Cursor（claude_desktop_config.json または mcp.json）の場合：

{
	"mcpServers": {
		"brain": {
			"command": "npx",
			"args": ["-y", "@three-ws/brain-mcp"],
			"env": { "THREE_WS_API_KEY": "sk_live_…" }
		}
	}
}

MCP Inspector で提供機能を確認します。

npx -y @modelcontextprotocol/inspector npx @three-ws/brain-mcp

ツール

ツール	種類	説明
list_providers	読み取り専用	ルーターからアクセスできるすべての LLM を一覧表示します。キー、ネットワーク、ティア、最大出力、リアルタイムの利用可否、認証の要否を確認できます。
chat	読み取り専用	選択したプロバイダーでチャット補完を実行し、応答全文、使用したルート、トークン使用量、所要時間を返します。

どちらのツールもリアルタイムのデータを読み取ります。プロバイダーの構成や補完結果は呼び出しごとに変わるため、どちらも冪等ではありません。chat はプラットフォームの状態を変更しないため、読み取り専用として注釈されています。

入力パラメーター

list_providers — パラメーターはありません。

chat — messages（必須：{ role: "user" | "assistant", content } 形式のターンを 1～100 件。content は最大 16,000 文字）、provider（list_providers から指定するプロバイダーキー。デフォルトは gpt-oss-120b）、system（任意のシステムプロンプト。最大 8,000 文字）、maxTokens（任意。64～16384、デフォルトは 4096。モデルの上限に合わせて調整されます）。

使用例

以下の 2 つの応答は、形式を示す例です。実際のプロバイダー構成や生成結果は異なります。

// list_providers (example response)
> {}
{
  "ok": true,
  "count": 34,
  "available": 33,
  "default_provider": "gpt-oss-120b",
  "providers": [
    { "key": "gpt-oss-120b", "label": "GPT-OSS 120B", "network": "OpenAI · OpenRouter", "tier": "balanced", "maxOutput": 8192, "description": "Open-weight 120B from OpenAI. Fast, capable, free tier. Platform default.", "available": true, "requiresAuth": false },
    { "key": "claude-sonnet-5", "label": "Claude Sonnet 5", "network": "Anthropic", "tier": "balanced", "maxOutput": 16384, "description": "Near-Opus quality on coding and agentic work at Sonnet cost. Best for most tasks.", "available": true, "requiresAuth": true },
    { "key": "deepseek-r1", "label": "DeepSeek R1", "network": "DeepSeek", "tier": "reasoning", "maxOutput": 8192, "description": "Open reasoning model. Strong at math and code.", "available": true, "requiresAuth": true }
    /* … */
  ]
}

// chat (example response)
> {
    "provider": "claude-sonnet-5",
    "system": "You are terse.",
    "messages": [{ "role": "user", "content": "Name three Solana RPC methods." }]
  }
{
  "ok": true,
  "provider": "claude-sonnet-5",
  "model": "Claude Sonnet 5",
  "network": "Anthropic",
  "tier": "balanced",
  "routed_via": null,
  "content": "getBalance, getAccountInfo, getSignaturesForAddress.",
  "usage": { "input_tokens": 24, "output_tokens": 14, "total_tokens": 38 },
  "timing_ms": { "first_token": 412, "total": 980 }
}

要求したプロバイダーが直接応答した場合、routed_via は null になります。それ以外の場合は、ルーターがフォールバックしたミラーまたは無料ティアのルートが示されます。そのため、最初に選んだモデルが一時的に停止していても、必ず応答を得られます。

モデルの利用可否は動的に変化します。キーをハードコードせず、必ず最初に list_providers を呼び出してください。現在の Claude ID は claude-fable-5、claude-opus-5、claude-sonnet-5、claude-opus-4-7、claude-sonnet-4-6、claude-haiku-4-5 ですが、最新の一覧を正としてください。

認証

モデルクラス	キーが必要ですか？
無料のオープンウェイトティア（GPT-OSS 120B、およびNVIDIA NIMセット：Nemotron 3 Super / Nemotron Super 49B / Nemotron Nano / DeepSeek V4 / Kimi K2 / Llama 4 Maverick / MiniMax M2）	いいえ
有料のファーストパーティフラッグシップ（Claude、GPT-5.6、o3、Qwen Plus、DeepSeek、…）	はい — THREE_WS_API_KEY を設定してください

three.ws/dashboard/developers でAPIキーを作成してください。キーがない場合、有料モデルはサインインエラーを返し、list_providers では requiresAuth: true として示されます。

要件

• Node.js >= 20。
• https://three.ws（または独自の THREE_WS_BASE）へのネットワークアクセス。

環境変数

変数	必須	デフォルト	用途
THREE_WS_BASE	いいえ	https://three.ws	APIベースURL（セルフホストする場合やプレビュー環境を指定する場合に上書きします）。
THREE_WS_API_KEY	いいえ	—	有料のファーストパーティフラッグシップを利用可能にするベアラー認証情報です。
THREE_WS_TIMEOUT_MS	いいえ	120000	リクエストごとのタイムアウト（補完はサーバー側でストリーミングされます）。

エラー

ツール呼び出しが失敗すると、MCPエラー結果（isError: true）が返されます。テキストは単一のJSONオブジェクト（{ "ok": false, "error": "<code>", "message": "…" }）で、上流からの拒否時には status と detail も含まれます。

error	意味	対処
upstream_error	ルーターがリクエストを拒否しました — status には実際のHTTPコードが入ります。400（引数が不正、または不明なプロバイダーキー）、401（有効な THREE_WS_API_KEY が設定されていない有料モデル）、429（レート制限）、502（モデルのストリームが出力前に失敗）。	status に応じて対処してください。401 の場合はキーを設定し、不明なキーの場合は list_providers を再実行してください。
timeout	THREE_WS_TIMEOUT_MS 以内に完全な応答がありませんでした。フラッグシップモデルによる長時間の生成は遅くなることがあります — デフォルトの120秒はルーター独自の上限と一致しています。	再試行するか、maxTokens を減らすか、fast ティアのプロバイダーを選択してください。
network_error	リクエストがルーターに到達しませんでした（DNS、オフライン、TLS）。	接続状況と THREE_WS_BASE を確認してください。
bad_config	THREE_WS_TIMEOUT_MS が正の数ではありません（起動時にスローされます）。	環境変数を修正してください。

要求されたプロバイダーが処理中に失敗した場合、ルーターはミラーまたは無料ティアに透過的にフォールバックし、応答の routed_via に使用されたルートが示されます。すべてのルートを使い切った場合にのみエラーが表示されます。

リンク

• ホームページ：https://three.ws
• 変更履歴：https://three.ws/changelog
• 課題：https://github.com/nirholas/three.ws/issues
• ライセンス：Apache-2.0、LICENSE を参照

---

_{3D AI エージェント、オンチェーンID、エージェント決済を提供する three.ws SDKスイートの一部です。
ウェブサイト · 変更履歴 · GitHub}