MCP Router

🚀 MCP ルーター

MCP ルーターは、Model Context Protocol (MCP) に準拠したサーバーとのインタラクションや、OpenRouter LLM 機能の統合を行う Python パッケージです。MCP サーバーの管理、エージェントベースのタスクの実行、Upsonic フレームワークを使用した複雑なワークフローの調整などのバックエンド機能を提供します。

🚀 クイックスタート

MCP ルーターを使用することで、MCP サーバーとのインタラクションや、OpenRouter を通じた AI 機能の利用が可能になります。以下に基本的な使用方法を示します。

✨ 主な機能

• MCP サーバー管理：MCP サーバーの追加、編集、削除を行います。
• OpenRouter 統合：OpenRouter モデルを直接クエリして、AI 支援タスクを実行します。
• Upsonic 統合：Upsonic を使用して、複雑な多段階ワークフローを調整します。
• スマートタスク分析：タスクを完了するために必要なツールを自動的に決定します。
• MCP プロトコルサポート：MCP サーバーとの標準化されたインタラクションを行います。
• API フレームワーク：REST API エンドポイントを通じて機能を公開します。

🏗️ アーキテクチャ

このパッケージの構造は以下の通りです。

mcp_router/
├── __init__.py
├── main.py
├── cli/           # コマンドラインインターフェース
├── core/          # 核心 MCP 和 Upsonic 集成
├── server_management/ # MCP サーバー管理
└── utils/         # ユーティリティ関数

📋 前提条件

• Python 3.8+
• Docker（オプションですが、MCP サーバーの実行に推奨）

📦 インストール

リポジトリをクローンする

git clone https://github.com/codewithkenzo/mcp-router.git
cd mcp-router

Python パッケージをインストールする

# 仮想環境を作成する（推奨）
python -m venv .venv
source .venv/bin/activate  # Windows の場合は：.venv\Scripts\activate

# 依存関係をインストールする
pip install -r requirements.txt

# 開発モードでパッケージをインストールする
pip install -e .

💻 使用例

モジュールとして使用する

import mcp_router

# MCP サーバーマネージャーを初期化する
server_manager = mcp_router.core.server_manager.ServerManager()

# 利用可能な MCP サーバーを取得する
servers = server_manager.get_servers()

# OpenRouter 統合を使用する
from mcp_router.core import openrouter
response = openrouter.query("告诉我关于 MCP 的信息")

CLI を実行する

# プロジェクトのルートディレクトリで、仮想環境がアクティブな状態で
python -m mcp_router.cli.cli --help

🧩 コンポーネント

MCP サーバー管理

サーバー管理モジュールは以下のことを処理します。

• ~/.cursor/mcp.json から MCP サーバーの設定を読み取ります。
• MCP サーバーの起動と停止を行います。
• MCP サーバーとの通信を行います。

Upsonic 統合

Upsonic 統合により以下が可能になります。

• MCP ツールを使用してエージェントワークフローを作成します。
• タスクを分析して必要なツールを決定します。
• 様々な MCP 機能を持つ多段階タスクを実行します。

OpenRouter 統合

OpenRouter モジュールは以下を提供します。

• 単一の API を通じて複数の LLM プロバイダーにアクセスします。
• クエリの生成と応答の処理を行います。
• Token 使用量の追跡を行います。

🤝 コントリビューション

コントリビューションを歓迎します！自由に Pull Request を送信してください。

1. リポジトリをフォークする
2. 機能ブランチを作成する (git checkout -b feature/amazing-feature)
3. 変更をコミットする (git commit -m '添加一些很棒的功能')
4. ブランチにプッシュする (git push origin feature/amazing-feature)
5. Pull Request を開く

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。詳細については、LICENSE ファイルを参照してください。

🙏 謝辞

• Model Context Protocol は MCP 仕様を提供しています。
• OpenRouter は様々な LLM モデルへのアクセスを提供しています。
• Upsonic はエージェントフレームワークを提供しています。