Routara LLM Gateway

Routara MCP サーバー

Routara 公式の Model Context Protocol サーバーです。Cursor、Claude Desktop、Codex、Windsurf、VS Code、その他の MCP クライアントから Routara のチャット、画像、動画モデルを利用できます。

• ウェブサイトとセットアップガイド：https://routara.ai/mcp?utm_source=github&utm_medium=repository&utm_campaign=mcp_quickstart
• OpenAI 互換 API：https://api.routara.ai/v1
• API キーの作成：https://routara.ai/auth?mode=register&returnTo=%2Fapp&utm_source=github&utm_medium=repository&utm_campaign=mcp_quickstart
• OpenAI SDK の最初のリクエストを実行：Python と Node.js のクイックスタート
• Postman で API を試す：インポート可能な最初のリクエスト用コレクション

実践的なガイド：Python SDK · Node.js SDK · Cursor MCP · Claude Desktop MCP

インストール

npx -y routara-mcp

または、最新の GitHub リリースからワンクリックで routara-mcp.mcpb バンドルをインストールしてください。

ツール

ツール	説明
routara_list_models	最新のモデルカタログを検索し、ページごとに表示します
routara_chat	ツール呼び出しを含む、単一ターンまたは複数ターンのチャット
routara_generate_image	テキストからの画像生成と参照画像を使った画像生成
routara_generate_video	テキストからの動画生成と画像からの動画生成のリクエスト
routara_get_video_status	非同期の動画タスクの状態を確認します

MCP クライアントの設定

{
  "mcpServers": {
    "routara": {
      "command": "npx",
      "args": ["-y", "routara-mcp"],
      "env": {
        "ROUTARA_API_KEY": "sk-or-v1-YOUR_KEY_HERE"
      }
    }
  }
}

OpenAI Codex

[mcp_servers.routara]
command = "npx"
args = ["-y", "routara-mcp"]
enabled = true

[mcp_servers.routara.env]
ROUTARA_API_KEY = "sk-or-v1-YOUR_KEY_HERE"

設定を追加したら、MCP クライアントを再起動し、Routara のモデル一覧を表示するよう依頼してください。次に、アカウントで利用可能なモデルを指定して routara_chat を使うよう依頼してください。MCP 接続によってツールが利用可能になりますが、ホストアプリケーション独自のモデルサブスクリプションや請求が置き換わるわけではありません。

環境変数

変数	必須	デフォルト
ROUTARA_API_KEY	ツール呼び出しには必須	なし
ROUTARA_API_BASE	いいえ	https://api.routara.ai/v1
ROUTARA_API_TIMEOUT_MS	いいえ	30000

API キーがなくても、プロセスは起動して MCP ハンドシェイクを完了できます。キーが解決されるのは Routara のツールを呼び出したときのみなので、ディレクトリはサーバーを安全に検証できます。

信頼性と互換性

• リクエストは無期限に停止せず、タイムアウトします。
• 一時的なネットワークエラー、HTTP 429、HTTP 5xx のレスポンスは、上限付きのバックオフを使って再試行します。
• API エラーには、利用可能な場合、上流リクエスト ID と再試行までの待ち時間が含まれます。
• routara_chat は OpenAI 互換レスポンス全体を返し、推論コンテンツとツール呼び出しを保持します。
• メディアのパラメーターは明示的に指定された場合にのみ転送されます。モデルごとに対応状況は異なります。

開発

npm ci
npm run build
npm test
npm run validate:registry
npm run build:mcpb

実際の API を使ったスモークテストを行うには：

ROUTARA_API_KEY=sk-or-v1-... npm run test:live

ディレクトリ掲載先

• npm
• 公式 MCP Registry
• Glama
• mcp.so
• Smithery
• PulseMCP

セキュリティ

API キーをコミットしないでください。キーが漏えいした場合は、直ちに Routara ダッシュボードで無効化してください。セキュリティ上の問題は、[email protected] まで非公開でご報告ください。

ライセンス

MIT