OpenRouter Agents MCP Server

OpenRouter Agents MCP サーバー

マルチエージェント AI リサーチ向けの本番環境用 MCP サーバーです。計画し、並列化し、統合します。

インストール

npx @terminals-tech/openrouter-agents --stdio

Claude Code のワンライナー：

claude mcp add openrouter-agents -- npx @terminals-tech/openrouter-agents --stdio

新機能（v2.0.0）

• MCP SDK 1.27.1 — registerTool/registerPrompt/registerResource API、セキュリティ修正
• Zod 4 — Zod 3 からアップグレード。z.record() の構文、設定スキーマの修正
• Express 5 — Express 4 からアップグレード。最新のパスパターン、req.query の処理
• ストリーミング可能な HTTP — 主要なトランスポート（SSE はレガシーなフォールバックとして非推奨）
• サーキットブレーカー — 設定可能なしきい値によるモデル API のフォールトトレランス
• 埋め込みベースのモデルルーティング — モデル選択のためのローカルなベクトル類似度（LLM 呼び出し不要）
• 永続ストレージ — レポート、ジョブ、ナレッジグラフはデフォルトでセッションをまたいで保持されます

macOS/Node 25 に関する注意：シャットダウン時に、見た目上の libc++abi: mutex lock failed メッセージが表示される場合があります。これは問題ありません。シャットダウン前にデータはチェックポイントに保存されます。インメモリモード（永続化なし、メッセージなし）にするには、DB_AUTO_HEAL=true を設定してください。

変更履歴の全文 | 拡張機能ガイド | MCP 準拠レポート

設定

環境変数に OPENROUTER_API_KEY を設定し、.env または .mcp.json で構成します。

ENV リファレンス全文

{
  "mcpServers": {
    "openrouter-agents": {
      "command": "npx",
      "args": ["@terminals-tech/openrouter-agents", "--stdio"],
      "env": {
        "OPENROUTER_API_KEY": "${OPENROUTER_API_KEY}",
        "INDEXER_ENABLED": "true"
      }
    }
  }
}

マルチクライアントのセットアップ

トランスポートモード

MCP 仕様に基づき、STDIO がデフォルトのトランスポートです。HTTP モードでは --http を明示的に指定してください。

クライアント別のセットアップ

{
  "mcpServers": {
    "openrouter-agents": {
      "command": "npx",
      "args": ["@terminals-tech/openrouter-agents"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-..."
      }
    }
  }
}

{
  "command": "npx",
  "args": ["@terminals-tech/openrouter-agents"],
  "env": { "OPENROUTER_API_KEY": "..." }
}

機能マトリックス

モデル（v2.0.0）

高コスト階層

低コスト階層

モデルは埋め込みベースのルーティングで選択されます。クエリの埋め込みをモデルのドメインプロファイルと照合し、LLM の呼び出しを行わずに選択します。

ツール

MCP 準拠

MCP 仕様 2025-11-25（安定版、AAIF／Linux Foundation のガバナンス）に準拠しています。

完全な準拠レポート

アーキテクチャ

User Query
    │
    ▼
┌─────────────────┐
│  Planning Agent  │ ─── Decomposes into sub-queries
└────────┬────────┘
         │
    ┌────┴────┐
    ▼         ▼
┌───────┐ ┌───────┐
│Agent 1│ │Agent N│ ─── Parallel research (embedding-routed models)
└───┬───┘ └───┬───┘
    │         │
    ▼         ▼
┌─────────────────┐
│   Synthesizer   │ ─── Consensus + citations (Signal protocol)
└────────┬────────┘
         │
         ▼
┌─────────────────┐
│  Knowledge Base  │ ─── PGlite + pgvector (persistent)
└─────────────────┘

コア抽象化

Circuit Breaker

モデル API の障害の連鎖を防ぎます。環境変数で設定できます。

状態：closed（通常） -> open（障害発生中、リクエストを拒否） -> half-open（復旧をテスト中）。

トランスポート（v2.0.0）

リンク

• ホームページ： terminals.tech
• npm： @terminals-tech/openrouter-agents
• GitHub： terminals-tech/openrouter-agents
• ドキュメント： CLAUDE.md | ツールのパターン | はじめに

リリース

リリースは release-please を使用して自動化されています。

1. main に規約に沿ったコミットをプッシュします（例：feat:、fix:、chore:）
2. release-please がバージョン更新の PR を作成します
3. PR をマージすると、GitHub Release が自動的に作成されます
4. リリース時に CI 経由で npm の公開が実行されます

手動で公開する場合：

npm test && npm publish --access public

バージョン： 2.0.0 | MCP SDK： 1.27.1 | MCP Spec： 2025-11-25 | 作者： Tej Desai | ライセンス： MIT