MCP Router

🚀 MCP 路由器

MCP 路由器是一個 Python 包，用於與遵循 Model Context Protocol (MCP) 的服務器進行交互，並集成了 OpenRouter 的大語言模型（LLM）功能。它提供了一個後端，可用於管理 MCP 服務器、執行基於代理的任務，以及使用 Upsonic 框架協調複雜的工作流。

🚀 快速開始

MCP 路由器是一個強大的 Python 包，能助力你與 MCP 服務器交互，集成 OpenRouter 的 LLM 功能。以下是使用它的簡單步驟：

安裝

# 克隆倉庫
git clone https://github.com/codewithkenzo/mcp-router.git
cd mcp-router

# 創建一個虛擬環境（推薦）
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 服務器管理：可添加、編輯和刪除 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 服務器）

🧩 組件

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 提供代理框架。