OpenRouter MCP マルチモーダルサーバー
OpenRouter.aiの多様なモデルエコシステムを通じて、チャットと画像分析機能を提供するMCP（Model Context Protocol）サーバー。このサーバーは、テキストチャット機能と強力な画像分析機能を組み合わせています。
特徴
テキストチャット:
OpenRouter.aiのすべてのチャットモデルに直接アクセス
シンプルなテキストとマルチモーダル会話のサポート
設定可能な温度およびその他のパラメータ
画像解析:
カスタムの質問で単一の画像を分析する
複数の画像を同時に処理する
画像の自動サイズ変更と最適化
さまざまな画像ソース（ローカルファイル、URL、データURL）のサポート
モデル選択:
利用可能なモデルを検索してフィルタリングする
モデルIDを検証する
詳細なモデル情報を取得する
デフォルトのモデル構成のサポート
パフォーマンスの最適化:
スマートモデル情報キャッシュ
再試行のための指数バックオフ
自動レート制限処理
Related MCP server: VRChat MCP OSC
1.5.0の新機能
OS互換性の向上:
Windows、macOS、Linux 向けの強化されたパス処理
ドライブ文字を使用した Windows スタイルのパスのサポートが向上
プラットフォーム間で一貫した動作を実現する正規化されたパス処理
MCP 構成サポート:
環境変数を必要とせずにカーソルMCPを統合
MCPパラメータによる直接設定
柔軟なAPIキーとモデル仕様オプション
堅牢なエラー処理:
画像処理のフォールバックメカニズムの改善
特定の診断によるエラーレポートの改善
ファイル読み取りのための複数のバックアップ戦略
画像処理の強化:
すべての画像タイプでより信頼性の高い base64 エンコード
シャープモジュールが利用できない場合のフォールバックオプション
自動最適化による大きな画像の処理の改善
インストール
オプション1: npm経由でインストールする
npm install -g @stabgan/openrouter-mcp-multimodalオプション2: Docker経由で実行
docker run -i -e OPENROUTER_API_KEY=your-api-key-here stabgandocker/openrouter-mcp-multimodal:latestクイックスタート構成
前提条件
OpenRouter KeysからOpenRouter APIキーを取得します。
デフォルトモデルを選択する（オプション）
MCP 構成オプション
MCP 設定ファイル (例: cline_mcp_settings.jsonまたはclaude_desktop_config.json ) に次のいずれかの構成を追加します。
オプション 1: npx (Node.js) を使用する
{
"mcpServers": {
"openrouter": {
"command": "npx",
"args": [
"-y",
"@stabgan/openrouter-mcp-multimodal"
],
"env": {
"OPENROUTER_API_KEY": "your-api-key-here",
"DEFAULT_MODEL": "qwen/qwen2.5-vl-32b-instruct:free"
}
}
}
}オプション2: uv (Python パッケージ マネージャー) を使用する
{
"mcpServers": {
"openrouter": {
"command": "uv",
"args": [
"run",
"-m",
"openrouter_mcp_multimodal"
],
"env": {
"OPENROUTER_API_KEY": "your-api-key-here",
"DEFAULT_MODEL": "qwen/qwen2.5-vl-32b-instruct:free"
}
}
}
}オプション3: Dockerを使用する
{
"mcpServers": {
"openrouter": {
"command": "docker",
"args": [
"run",
"--rm",
"-i",
"-e", "OPENROUTER_API_KEY=your-api-key-here",
"-e", "DEFAULT_MODEL=qwen/qwen2.5-vl-32b-instruct:free",
"stabgandocker/openrouter-mcp-multimodal:latest"
]
}
}
}オプション4: Smitheryを使用する（推奨）
{
"mcpServers": {
"openrouter": {
"command": "smithery",
"args": [
"run",
"stabgan/openrouter-mcp-multimodal"
],
"env": {
"OPENROUTER_API_KEY": "your-api-key-here",
"DEFAULT_MODEL": "qwen/qwen2.5-vl-32b-instruct:free"
}
}
}
}例
このMCPサーバーの使用方法に関する包括的な例については、 examplesディレクトリをご覧ください。以下を提供しています。
Node.js アプリケーション用の JavaScript の例
インタラクティブなチャット機能を備えた Python の例
さまざまなアプリケーションと統合するためのコードスニペット
各例には、わかりやすいドキュメントとステップバイステップの説明が付属しています。
依存関係
このプロジェクトでは、次の主要な依存関係を使用します。
@modelcontextprotocol/sdk: ^1.8.0 - ツール実装用の最新の MCP SDKopenai: ^4.89.1 - OpenRouter 用の OpenAI 互換 API クライアントsharp: ^0.33.5 - 高速画像処理ライブラリaxios: ^1.8.4 - APIリクエスト用のHTTPクライアントnode-fetch: ^3.3.2 - 最新のフェッチ実装
Node.js 18以降が必要です。すべての依存関係は、互換性とセキュリティを確保するために定期的に更新されます。
利用可能なツール
mcp_openrouter_chat_completion
OpenRouter モデルにテキストまたはマルチモーダル メッセージを送信します。
use_mcp_tool({
server_name: "openrouter",
tool_name: "mcp_openrouter_chat_completion",
arguments: {
model: "google/gemini-2.5-pro-exp-03-25:free", // Optional if default is set
messages: [
{
role: "system",
content: "You are a helpful assistant."
},
{
role: "user",
content: "What is the capital of France?"
}
],
temperature: 0.7 // Optional, defaults to 1.0
}
});画像付きのマルチモーダルメッセージの場合:
use_mcp_tool({
server_name: "openrouter",
tool_name: "mcp_openrouter_chat_completion",
arguments: {
model: "anthropic/claude-3.5-sonnet",
messages: [
{
role: "user",
content: [
{
type: "text",
text: "What's in this image?"
},
{
type: "image_url",
image_url: {
url: "https://example.com/image.jpg"
}
}
]
}
]
}
});