OpenRouter MCP サーバー
OpenRouter.aiの多様なモデルエコシステムとのシームレスな統合を実現するモデルコンテキストプロトコル（MCP）サーバー。キャッシュ、レート制限、エラー処理を内蔵した統合型セーフインターフェースを通じて、様々なAIモデルにアクセスできます。
特徴
モデルアクセス
すべてのOpenRouter.aiモデルへの直接アクセス
自動モデル検証と機能チェック
デフォルトのモデル構成のサポート
パフォーマンスの最適化
スマートモデル情報のキャッシュ（1時間で有効期限切れ）
自動レート制限管理
失敗したリクエストに対する指数バックオフ
統一応答形式
すべてのレスポンスに一貫した
ToolResult構造isErrorフラグでエラー識別をクリアするコンテキスト付きの構造化されたエラーメッセージ
Related MCP server: MindBridge MCP Server
インストール
pnpm install @mcpservers/openrouterai構成
前提条件
OpenRouter KeysからOpenRouter APIキーを取得します。
デフォルトモデルを選択する（オプション）
環境変数
OPENROUTER_API_KEY=your-api-key-here
OPENROUTER_DEFAULT_MODEL=optional-default-model設定
MCP 設定構成ファイル ( cline_mcp_settings.jsonまたはclaude_desktop_config.json ) に追加します。
{
"mcpServers": {
"openrouterai": {
"command": "npx",
"args": ["@mcpservers/openrouterai"],
"env": {
"OPENROUTER_API_KEY": "your-api-key-here",
"OPENROUTER_DEFAULT_MODEL": "optional-default-model"
}
}
}
}応答フォーマット
すべてのツールは、標準化された構造で応答を返します。
interface ToolResult {
isError: boolean;
content: Array<{
type: "text";
text: string; // JSON string or error message
}>;
}成功例:
{
"isError": false,
"content": [{
"type": "text",
"text": "{\"id\": \"gen-123\", ...}"
}]
}エラー例:
{
"isError": true,
"content": [{
"type": "text",
"text": "Error: Model validation failed - 'invalid-model' not found"
}]
}利用可能なツール
チャット完了
OpenRouter.ai モデルにメッセージを送信します。
interface ChatCompletionRequest {
model?: string;
messages: Array<{role: "user"|"system"|"assistant", content: string}>;
temperature?: number; // 0-2
}
// Response: ToolResult with chat completion data or error検索モデル
利用可能なモデルを検索してフィルタリングします:
interface ModelSearchRequest {
query?: string;
provider?: string;
minContextLength?: number;
capabilities?: {
functions?: boolean;
vision?: boolean;
};
}
// Response: ToolResult with model list or errorモデル情報を取得する
特定のモデルに関する詳細情報を取得します。
{
model: string; // Model identifier
}検証モデル
モデル ID が有効かどうかを確認します。
interface ModelValidationRequest {
model: string;
}
// Response:
// Success: { isError: false, valid: true }
// Error: { isError: true, error: "Model not found" }エラー処理
サーバーは、コンテキスト情報を含む構造化されたエラーを提供します。
// Error response structure
{
isError: true,
content: [{
type: "text",
text: "Error: [Category] - Detailed message"
}]
}一般的なエラー カテゴリ:
Validation Error: 入力パラメータが無効ですAPI Error: OpenRouter API通信の問題Rate Limit: リクエストスロットリング検出Internal Error: サーバー側の処理エラー
応答の処理:
async function handleResponse(result: ToolResult) {
if (result.isError) {
const errorMessage = result.content[0].text;
if (errorMessage.startsWith('Error: Rate Limit')) {
// Handle rate limiting
}
// Other error handling
} else {
const data = JSON.parse(result.content[0].text);
// Process successful response
}
}発達
詳細については、 CONTRIBUTING.md を参照してください。
開発セットアップ
プロジェクト構造
機能実装
エラー処理ガイドライン
ツールの使用例
# Install dependencies
pnpm install
# Build project
pnpm run build
# Run tests
pnpm test変更履歴
以下の内容を含む最近の更新については、 CHANGELOG.md を参照してください。
統一された応答形式の実装
強化されたエラー処理システム
型安全なインターフェースの改善
ライセンス
このプロジェクトは、Apache License 2.0 に基づいてライセンスされています。詳細については、 LICENSEファイルを参照してください。
Resources
Looking for Admin?
Admins can modify the Dockerfile, update the server description, and track usage metrics. If you are the server author, to access the admin panel.