项目简介

MCP Router 是一款桌面应用,旨在简化 Model Context Protocol (MCP) 服务器的管理。它自身也是一个强大的 MCP 服务器,能够聚合多个本地或远程 MCP 服务器的能力(如资源、工具和提示模板),并向 LLM 客户端提供一个统一的访问接口。无论是运行在命令行还是桌面应用中,MCP Router 都能作为您所有 MCP 服务的中央枢纽。

主要功能点

  • 多服务器聚合: 将多个 MCP 服务器(包括本地进程和远程服务)的能力统一到一个 MCP 接口下,简化客户端集成。
  • 统一接口: 提供单一的 HTTP 或 Stdio 接口,供各种 LLM 应用和客户端(如 Claude、Cursor 等)连接和使用。
  • 集中管理: 通过直观的用户界面,轻松启动、停止、添加和配置 MCP 服务器。
  • 工具与资源路由: 智能路由对工具调用和资源读取的请求到正确的后端 MCP 服务器。
  • 会话管理与日志: 支持客户端会话管理,并提供详细的请求日志和状态监控。
  • 跨平台桌面应用: 支持 Windows 和 macOS,提供图形用户界面。

安装步骤

  • 桌面应用安装 (推荐):
    1. 访问 MCP Router 的 发布页面
    2. 下载适用于您操作系统的最新安装包 (如 '.exe' for Windows, '.dmg' for macOS)。
    3. 按照安装向导的指示完成安装。
  • 命令行工具安装 (CLI):
    1. 确保您已安装 Node.js (v18+) 和 npm/pnpm/yarn。
    2. 使用 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 管理的后端服务器,确保安全性。

基本使用方法

  • 通过桌面应用:

    1. 启动 MCP Router 桌面应用。
    2. 在应用界面中,导航到 "Servers" (服务器) 选项卡。
    3. 点击 "Add Server" (添加服务器) 按钮,您可以选择添加本地 MCP 进程或远程 MCP 服务。
    4. 配置好服务器后,点击 "Start" (启动) 按钮运行它。
    5. 您的 LLM 客户端即可通过 MCP Router 提供的接口(通常是 'http://localhost:3282/mcp')访问这些服务器聚合后的能力。
  • 通过命令行工具 (CLI):

    1. 启动聚合服务器: 使用 '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服务器的命令行命令
    2. MCP Router 将在默认端口 '3283' 上启动 HTTP 聚合服务器。
    3. LLM 客户端可以连接到 'http://localhost:3283' 来使用聚合后的 MCP 服务。
    4. 将 HTTP 服务转换为 Stdio: 使用 'mcpr-cli connect' 命令可以将 MCP Router 内部的 HTTP 聚合服务转换为标准输入输出 (Stdio) 协议,供支持 Stdio 的客户端使用。
      mcpr-cli connect --port 3282
      # 解释:
      # --port 3282: 指定要连接的MCP Router HTTP服务的端口(桌面应用默认是3282)

信息

分类

AI与计算