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