MCP Router

MCP Router 是一个 Python 包，用于与具有 OpenRouter LLM 集成的 Model Context Protocol (MCP) 服务器进行交互。它提供了一个后端，用于管理 MCP 服务器、执行基于代理的任务以及使用 Upsonic 框架编排复杂的工作流程。

🚀 功能

• 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("Tell me about MCP")

运行 CLI

# 从项目根目录，激活虚拟环境
python -m mcp_router.cli.cli --help

🧩 组件

MCP 服务器管理

服务器管理模块处理：

• 从 ~/.cursor/mcp.json 读取 MCP 服务器配置
• 启动和停止 MCP 服务器
• 与 MCP 服务器通信

Upsonic 集成

Upsonic 集成允许：

• 使用 MCP 工具创建代理工作流程
• 分析任务以确定所需的工具
• 使用各种 MCP 功能执行多步骤任务

OpenRouter 集成

OpenRouter 模块提供：

• 通过单个 API 访问多个 LLM 提供商
• 查询生成和响应处理
• 令牌使用情况跟踪

🤝 贡献

欢迎贡献！请随时提交 Pull Request。

1. Fork 仓库
2. 创建您的功能分支 (git checkout -b feature/amazing-feature)
3. 提交您的更改 (git commit -m 'Add some amazing feature')
4. 推送到分支 (git push origin feature/amazing-feature)
5. 打开一个 Pull Request

📄 许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

🙏 致谢

• Model Context Protocol 用于 MCP 规范
• OpenRouter 用于提供对各种 LLM 模型的访问
• Upsonic 用于代理框架