项目简介
MCP Router 是一款桌面应用,旨在简化 Model Context Protocol (MCP) 服务器的管理。它自身也是一个强大的 MCP 服务器,能够聚合多个本地或远程 MCP 服务器的能力(如资源、工具和提示模板),并向 LLM 客户端提供一个统一的访问接口。无论是运行在命令行还是桌面应用中,MCP Router 都能作为您所有 MCP 服务的中央枢纽。
主要功能点
- 多服务器聚合: 将多个 MCP 服务器(包括本地进程和远程服务)的能力统一到一个 MCP 接口下,简化客户端集成。
- 统一接口: 提供单一的 HTTP 或 Stdio 接口,供各种 LLM 应用和客户端(如 Claude、Cursor 等)连接和使用。
- 集中管理: 通过直观的用户界面,轻松启动、停止、添加和配置 MCP 服务器。
- 工具与资源路由: 智能路由对工具调用和资源读取的请求到正确的后端 MCP 服务器。
- 会话管理与日志: 支持客户端会话管理,并提供详细的请求日志和状态监控。
- 跨平台桌面应用: 支持 Windows 和 macOS,提供图形用户界面。
安装步骤
- 桌面应用安装 (推荐):
- 访问 MCP Router 的 发布页面。
- 下载适用于您操作系统的最新安装包 (如 '.exe' for Windows, '.dmg' for macOS)。
- 按照安装向导的指示完成安装。
- 命令行工具安装 (CLI):
- 确保您已安装 Node.js (v18+) 和 npm/pnpm/yarn。
- 使用 npm 安装全局 CLI 工具:'npm install -g @mcp_router/cli'
服务器配置 (作为聚合服务器)
MCP Router 自身作为一个聚合服务器,其配置由内部管理。您不需要手动编辑 JSON 文件来配置它。当您通过桌面应用或命令行工具('mcpr-cli serve' 命令)启动 MCP Router 时,它会监听一个端口,并自动作为 MCP 服务器运行。
- 桌面应用聚合服务器接口: 默认在 'http://localhost:3282/mcp' 提供 HTTP JSON-RPC 接口。
- CLI 'serve' 命令聚合服务器接口: 默认在 'http://0.0.0.0:3283' 提供 HTTP JSON-RPC 接口。
- CLI 'connect' 命令聚合服务器接口: 将桌面应用内部的 HTTP 聚合服务转换为标准输入输出 (Stdio) 协议,供支持 Stdio 的客户端使用。
MCP 客户端连接配置示例(非代码,仅为说明):
要连接到 MCP Router,您的 MCP 客户端需要配置以下信息:
- 服务器类型: HTTP
- URL:
- 连接桌面应用内部服务:'http://localhost:3282/mcp'
- 连接 CLI 'serve' 命令启动的服务:'http://localhost:3283'
- 认证令牌: 通常在 MCP Router 桌面应用界面生成,以 'Bearer <YOUR_TOKEN>' 形式提供。
- 备注: 令牌用于授权客户端访问 MCP Router 管理的后端服务器,确保安全性。
基本使用方法
-
通过桌面应用:
- 启动 MCP Router 桌面应用。
- 在应用界面中,导航到 "Servers" (服务器) 选项卡。
- 点击 "Add Server" (添加服务器) 按钮,您可以选择添加本地 MCP 进程或远程 MCP 服务。
- 配置好服务器后,点击 "Start" (启动) 按钮运行它。
- 您的 LLM 客户端即可通过 MCP Router 提供的接口(通常是 'http://localhost:3282/mcp')访问这些服务器聚合后的能力。
-
通过命令行工具 (CLI):
- 启动聚合服务器: 使用 'mcpr-cli serve' 命令启动一个 HTTP 聚合服务器,并指定要聚合的 MCP 服务器进程。
mcpr-cli serve --server my_local_server_id "我的本地工具服务" "python -m my_mcp_server_module" # 解释: # --server: 定义一个要聚合的MCP服务器 # my_local_server_id: 该服务器在MCP Router中的唯一ID # "我的本地工具服务": 该服务器的显示名称 # "python -m my_mcp_server_module": 启动该MCP服务器的命令行命令 - MCP Router 将在默认端口 '3283' 上启动 HTTP 聚合服务器。
- LLM 客户端可以连接到 'http://localhost:3283' 来使用聚合后的 MCP 服务。
- 将 HTTP 服务转换为 Stdio: 使用 'mcpr-cli connect' 命令可以将 MCP Router 内部的 HTTP 聚合服务转换为标准输入输出 (Stdio) 协议,供支持 Stdio 的客户端使用。
mcpr-cli connect --port 3282 # 解释: # --port 3282: 指定要连接的MCP Router HTTP服务的端口(桌面应用默认是3282)
- 启动聚合服务器: 使用 'mcpr-cli serve' 命令启动一个 HTTP 聚合服务器,并指定要聚合的 MCP 服务器进程。
信息
分类
AI与计算