MCP Research Router

🚀 MCP Research Router

MCP Research Routerは、MCPサーバーの管理やツールの利用に関する問題を解決するためのMCPアグリゲーターとスマートルーターです。一度の接続ですべてのMCPサーバーにアクセスでき、最適なツールを自動で推薦し、バッチ並列実行により性能を3 - 5倍に向上させます。

🚀 クイックスタート

1. インストール

npm install -g mcp-research-router
# または直接実行
npx mcp-research-router

2. 設定

推奨：環境変数の使用 MCPクライアントに環境変数を追加します。

MCP_LLM_ENABLED=true
MCP_LLM_API_KEY=your-api-key-here
MCP_LLM_BASE_URL=https://open.bigmodel.cn/api/paas/v4
MCP_LLM_MODEL=glm-4.7-flash
MCP_SERVER_URL=http://127.0.0.1:3000/mcp/your-group-id

3. クライアントへの接続

Claude DesktopやCursorなどのMCP対応クライアントの設定ファイルを編集します。

• Claude Desktop:
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
  • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Cursor:
  • Windows: %APPDATA%\Cursor\User\globalStorage\mcp_settings.json
  • Mac: ~/Library/Application Support/Cursor/User/globalStorage/mcp_settings.json

最小設定（サービスにのみ接続）：

{
  "mcpServers": {
    "mcp-research-router": {
      "command": "npx",
      "args": ["mcp-research-router"]
    }
  }
}

環境変数を含む設定：

{
  "mcpServers": {
    "mcp-research-router": {
      "command": "npx",
      "args": ["mcp-research-router"],
      "env": {
        "MCP_LLM_ENABLED": "true",
        "MCP_LLM_BASE_URL": "https://ark.cn-beijing.volces.com/api/coding/v3",
        "MCP_LLM_API_KEY": "your-api-key-here",
        "MCP_LLM_MODEL": "ark-code-latest",
        "MCP_SERVER_ENABLED": "true",
        "MCP_SERVER_URL": "http://your-server-url/mcp/endpoint",
        "MCP_SERVER_NAME": "my-server",
        "MCP_SERVER_HEADERS": "{\"Authorization\": \"Bearer your-token\"}"
      }
    }
  }
}

✨ 主な機能

1. 複数のMCPサーバーを統一管理

複数のMCPサーバーを集約し、一度の接続ですべてのツールにアクセスできます。各クライアントに個別に追加する必要はありません。

2. スマートツール推薦

あなたのニーズに基づいて、LLMを通じて最適なツールを自動で推薦します。長いツールリストを探す必要はありません。

3. バッチ並列実行

複数の関連ツールを同時に呼び出し、性能を3 - 5倍に向上させます。複数のツールの結果を総合する必要があるシナリオに適しています。

💻 使用例

基本的な使用法

ツールリストの取得

{
  "name": "get_tool_list"
}

スマートツール推薦

{
  "name": "get_tool_list",
  "arguments": {
    "user_query": "搜索关于人工智能的最新新闻",
    "max_tools": 3
  }
}

システムはあなたのニーズに基づいて最適なツールを推薦します。

ツールのバッチ実行

{
  "name": "execute_tools",
  "arguments": {
    "tools": [
      {
        "tool_name": "server-name-metaso-metaso_web_search",
        "arguments": {"q": "人工智能最新发展"}
      }
    ]
  }
}

📚 ドキュメント

このツールはあなたに適していますか？

✅ 使用に適している場合

• 複数のMCPサーバーを統一管理する必要がある
• ツールの数が多く、どれを使うかわからない
• 複数のツールをバッチで呼び出す必要がある
• LLMによるスマートツール推薦を利用したい

❌ 使用に適していない場合

• MCPサーバーが1つしかない
• ツールの数が少なく、直接選択できる
• スマート推薦機能が不要

あなたのクライアントがすでに複数のMCPの追加をサポートしており、ツールが少量の場合、このツールは必要ありません。

設定の説明

環境変数（推奨）

MCP_SERVER_HEADERSの使用方法

JSON形式の文字列を入力する必要があります。

MCP_SERVER_HEADERS={"Authorization": "Bearer your-token"}

例：

• Bearer Token認証: {"Authorization": "Bearer your-token"}
• API Key認証: {"X-API-Key": "your-api-key"}
• 複数のリクエストヘッダー: {"Authorization": "Bearer your-token", "X-Custom-Header": "value"}

設定ファイルの方法

設定ファイルを使用する場合は、config.json を編集します。

{
  "subAgent": {
    "enabled": true,
    "type": "openai",
    "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
    "apiKey": "your-api-key-here",
    "model": "glm-4.7-flash",
    "timeout": 90000
  },
  "mcpServers": {
    "enabled": true,
    "servers": [
      {
        "name": "my-favorites",
        "type": "streamable-http",
        "url": "http://127.0.0.1:3000/mcp/your-group-id"
      }
    ]
  }
}

完全な設定例は config.full.example.json を参照してください。

プロンプトモード

システムは複数のプロンプトモードをサポートしており、必要に応じて選択できます。

事前定義モード

• tool_recommendation（デフォルト）：高速なツール推薦
• deep_research：複雑なタスクに適した深い研究モード

カスタムモード

prompts/ フォルダ内に新しいフォルダを作成します。

prompts/
└── my_mode/
    ├── system.txt
    └── user.txt

使用時に prompt_mode: "my_mode" を渡します。 詳細な説明は prompts/README.md を参照してください。

よくある質問

Q: MCPHubグループをどのように設定しますか？

1. MCPHubのWebサイトでグループを作成します。
2. よく使用するMCPサーバーをグループに追加します。
3. グループIDをコピーします。
4. 環境変数を設定します：MCP_SERVER_URL=http://127.0.0.1:3000/mcp/グループID

⚠️ MCP Research Router自体をグループに追加しないでください。そうすると無限ループになります。

Q: LLMを設定しないで使用できますか？

できますが、機能が制限されます。

• ✅ ツールリストを取得できます。
• ✅ ツールを実行できます。
• ❌ スマート推薦機能を使用できません。

🔧 技術詳細（開発）

# 依存関係のインストール
pnpm install

# 開発モード（ホットリロードをサポート）
pnpm dev

# ビルド
pnpm build

# 実行
pnpm start

📄 ライセンス

MIT

🙏 支援

このプロジェクトがあなたに役立った場合、開発作業を支援するために微信での寄付を歓迎します。

🔗 関連リンク

• GitHubリポジトリ
• インストールガイド
• デプロイメントドキュメント
• 更新履歴