OpenRouter

🚀 OpenRouter モデル向けの単一 MCP サーバー 🚀

mcp-openrouter は、Codex、Claude Code、opencode、その他の MCP ホストから、ローカルの stdio ツールを通じて OpenRouter モデルを呼び出せる Python 製 MCP サーバーです。

リトライ処理、ホストを考慮したインストール、オプションのデフォルトモデル環境変数を備えた、小規模な FastMCP サーバーを通じて、チャット、画像生成、埋め込み、モデル一覧表示、モデル検索を提供します。

インストール

検出されたすべての MCP クライアントに公開済みサーバーをインストールします。

uvx mcp-openrouter install --yes

選択したクライアントにインストールします。

uvx mcp-openrouter install --yes --clients codex,claude,opencode

ローカルのチェックアウトから実行します。

git clone https://github.com/tsilva/mcp-openrouter.git
cd mcp-openrouter
uv sync --dev
keyenv doctor
keyenv run -- uv run mcp-openrouter

引数なしで mcp-openrouter を実行すると、stdio サーバーが起動します。明示的なコマンドは uv run mcp-openrouter serve です。

コマンド

uvx mcp-openrouter install --yes                 # install into detected MCP clients
uvx mcp-openrouter install --yes --force         # replace an existing openrouter config
uvx mcp-openrouter uninstall --yes               # remove from detected MCP clients
uv run mcp-openrouter                            # run the local stdio server
uv run pytest tests/test_cli.py tests/test_client.py tests/test_config.py tests/test_installer.py tests/test_release_metadata.py tests/test_server.py
keyenv run -- uv run pytest tests/test_tools.py
uv run ruff check src/
uv run ruff format src/

ツール

ツール	用途
chat	プロンプトまたはメッセージのリストを OpenRouter のチャットモデルに送信します。
generate_image	画像を 1 枚生成し、必要に応じて絶対パスで指定したローカルファイルに保存します。
embed	文字列または文字列のリストの埋め込みを生成します。
list_models	vision、image_gen、embedding、tools、long_context でフィルタリングして、モデルを一覧表示します。
find_models	モデル名とスラッグを検索し、一致したモデルを最大 20 件返します。

MCP プロンプトの例：

Use openrouter chat with anthropic/claude-sonnet-4 to summarize this file
Use openrouter generate_image with google/gemini-3-pro-image-preview to create a square app icon
Use openrouter embed with mistralai/mistral-embed-2312 to embed "Hello world"
Use openrouter list_models with capability "image_gen"
Use openrouter find_models to search for "claude"

設定

すべてのツール呼び出しには OPENROUTER_API_KEY が必要です。ローカルのチェックアウトでは、.keyenv.toml がこの変数を macOS Keychain にマッピングします。keyenv set OPENROUTER_API_KEY で値を置き換え、keyenv doctor で確認し、keyenv run -- ... でサーバーまたはライブテストを起動します。Python は引き続き os.environ から通常どおり値を読み取ります。

オプションのデフォルト値を設定すると、該当するツールでは model パラメーターを省略できます。

DEFAULT_TEXT_MODEL=google/gemini-3-pro-image-preview
DEFAULT_IMAGE_MODEL=google/gemini-3-pro-image-preview
DEFAULT_CODE_MODEL=anthropic/claude-sonnet-4.5
DEFAULT_VISION_MODEL=google/gemini-3-pro-image-preview
DEFAULT_EMBEDDING_MODEL=mistralai/mistral-embed-2312

現在のツールでは DEFAULT_TEXT_MODEL、DEFAULT_IMAGE_MODEL、DEFAULT_EMBEDDING_MODEL を読み取ります。クライアントの慣例に合わせて、DEFAULT_CODE_MODEL と DEFAULT_VISION_MODEL も使用できます。機密情報ではないデフォルト値は .env に保存してもかまいませんが、API キーは保存しないでください。

補足

• Python 3.10 以降が必要です。
• ホストにインストールされる公開版の実行コマンドは uvx mcp-openrouter です。
• 対応するインストーラーの対象は Codex、Claude Code、opencode です。
• generate_image.output_path には、/Users/you/output.png のような絶対パスを指定する必要があります。
• 単体テストではネットワーク呼び出しをモックします。tests/test_tools.py には有効な OPENROUTER_API_KEY が必要です。
• サーバーコードを変更した後は、MCP ホストを再起動して新しいサーバープロセスを起動してください。
• リリース前に server.json、CHANGELOG.md、パッケージのバージョンを同期してください。Makefile のリリース用ヘルパーは make release-x.y.z です。

ローカルでの MCP 開発

公開済みの PyPI パッケージではなく、作業中のワーキングツリーを MCP ホストで実行する場合は、ローカルのチェックアウトを登録してください。

Claude Code：

claude mcp add openrouter --scope user -- keyenv run --manifest /path/to/mcp-openrouter/.keyenv.toml -- uv run --directory /path/to/mcp-openrouter mcp-openrouter

Codex：

codex mcp add openrouter -- keyenv run --manifest /path/to/mcp-openrouter/.keyenv.toml -- uv run --directory /path/to/mcp-openrouter mcp-openrouter

opencode：

{
  "mcp": {
    "openrouter": {
      "type": "local",
      "command": ["keyenv", "run", "--manifest", "/path/to/mcp-openrouter/.keyenv.toml", "--", "uv", "run", "--directory", "/path/to/mcp-openrouter", "mcp-openrouter"],
      "enabled": true
    }
  }
}

アーキテクチャ

ライセンス

MIT