MCP 路由器

MCP 路由器是一个 Python 包，用于与遵循 Model Context Protocol (MCP) 的服务器交互，并集成 OpenRouter LLM 功能。它提供了一个后端来管理 MCP 服务器、执行基于代理的任务以及使用 Upsonic 框架协调复杂的 workflows。

🚀 功能

• MCP 服务器管理：添加、编辑和删除 MCP 服务器
• OpenRouter 集成：直接查询 OpenRouter 模型以执行 AI 辅助任务
• Upsonic 集成：使用 Upsonic 协调复杂的多步骤 workflows
• 智能任务分析：自动确定完成任务所需的工具
• 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 提供代理框架