Crazyrouter Mcp Server

Crazyrouter MCP：チャット、画像生成、モデルの検出

実用ガイド / 実践ガイド

• 製品コピー＋画像、モデルの検出＋画像の保存 / 実行可能なワークフロー
• バージョンと検証範囲 / 検証

2026-10-12 更新。この MCP サーバーは、API キーを使用して、対応クライアントを Crazyrouter に接続します。このリポジトリでは 3 つのツールを実装していますが、ゲートウェイのカタログにはこれらのツールより多くの項目があります。

ツール

ツール	API	範囲
chat	POST /v1/chat/completions	Chat Completions に対応するモデル向けのテキストメッセージ。デフォルトは gpt-4o-mini
list_models	GET /v1/models と公開エンドポイントのメタデータ	お使いのキーで利用できるモデル。カテゴリによる絞り込みは任意
generate_image	POST /v1/images/generations	同期画像 1 枚。デフォルトは gpt-image-2。サイズはモデルごとに異なります

モデルを検出できても、この MCP が各モデルのプロトコルを実装しているとは限りません。動画、音楽、文字起こし、TTS、Midjourney のタスクには、それぞれ独自の API が必要です。旧 generate_video 実装は動画モデルにチャットエンドポイントを送信していたため、削除されました。これらのタスク API については、API ドキュメントをご覧ください。

このサーバーは、検出に失敗した場合にハードコードされたモデル一覧へ黙って置き換えることはありません。認証エラーと検出エラーはクライアントに返されます。カテゴリは公開エンドポイントのメタデータと名前に基づく音声検出を使用し、種類が不明な項目は other に分類されます。

npm からインストール

Node.js 22 以降が必要です。

以下のように npx -y [email protected] を使うように MCP クライアントを設定し、CRAZYROUTER_API_KEY を設定してください。クライアントがサーバーを自動的に起動します。

ソースからビルドする場合：

git clone https://github.com/xujfcn/crazyrouter-mcp.git
cd crazyrouter-mcp
npm ci
npm run build

Claude Desktop または Cursor

Crazyrouter コンソールでキーを作成します。以下をクライアントの MCP 設定に追加し、キーをローカルで置き換えてください。

{
  "mcpServers": {
    "crazyrouter": {
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": { "CRAZYROUTER_API_KEY": "YOUR_CRAZYROUTER_API_KEY" }
    }
  }
}

Claude Desktop は claude_desktop_config.json を使用し、Cursor は .cursor/mcp.json に対応しています。編集後、クライアントを再起動してください。実際のキーを含む設定をコミットしないでください。

VS Code

.vscode/mcp.json と VS Code の MCP スキーマを使用します。

{
  "servers": {
    "crazyrouter": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "[email protected]"],
      "env": { "CRAZYROUTER_API_KEY": "${input:crazyrouter-api-key}" }
    }
  },
  "inputs": [
    { "type": "promptString", "id": "crazyrouter-api-key", "description": "Crazyrouter API key", "password": true }
  ]
}

ツール引数の例

{"model":"gpt-4o-mini","messages":[{"role":"user","content":"Reply OK"}],"max_tokens":16}

モデルのドキュメントに記載されたスキーマに従い、max_tokens と max_completion_tokens のいずれか一方だけを使用してください。対応していないモデルには、任意の temperature 値を送信しないでください。

{"category":"image"}

{"model":"gpt-image-2","prompt":"A simple blue circle on a white background","n":1}

画像出力は URL または base64 形式の画像になります。このツールは MCP を通じて両方の形式を返し、結果が空の場合は成功として報告しません。サイズの制約はモデルによって異なります。画像リクエストには、モデルの通常料金が適用されます。

料金とトラブルシューティング

• 現在のモデルと料金が正確な情報源です。固定のモデル数や一律の割引はありません。
• HTTP 400：モデル ID、エンドポイント、サイズ、その他のフィールドを正確に確認してください。最小限の例から始めてください。
• HTTP 401/403：キーと権限を確認してください。HTTP 429：クォータとレート制限を確認してください。
• ネイティブのタスク API が必要なモデルは、推論の前にチャット／画像ツールによって拒否されます。
• API のベース URL は https://crazyrouter.com/v1 に固定されており、マーケティング用パラメーターが API リクエストに追加されることはありません。

開発

npm ci
npm run build
npm test

テストでは、MCP クライアント／サーバー接続を介してモック HTTP レスポンスを使用します。2026-10-12 に、更新された MCP を介したライブチェックで、モデルの検出、最小限の gpt-4o-mini チャットリクエスト、1 回の gpt-image-2 画像リクエストが成功しました。これは、すべてのモデルやメディア操作がテスト済みであることを示すものではありません。メンテナーは node tests/live-smoke.mjs を実行できます。課金対象の画像リクエストを 1 回含めるには、--image を追加してください。

中国語の説明

このリポジトリは、テキストチャット、同期画像生成、リアルタイムのモデル検出という 3 つのツールをサポートしています。モデルカタログには動画、音楽などのカテゴリが表示されますが、これらの機能が MCP で実装済みであることを意味するものではありません。旧バージョンの動画ツールは誤ってチャットインターフェースを呼び出していたため、削除されました。API ドキュメントに従い、ネイティブのタスクインターフェースを使用してください。

Node.js 22+ を使用し、上記の設定に従って npx -y [email protected] で起動してください。リポジトリをクローンして npm ci と npm run build を実行し、ローカルの dist/index.js を MCP クライアントに設定することもできます。キーは CRAZYROUTER_API_KEY を通じて渡します。モデルカタログに表示される名称を正確な API ID として扱わないでください。また、宣伝用のパラメーターをインターフェースの URL に追加しないでください。

キーを作成 · 現在のモデルと価格

ライセンス

MIT