项目简介

MCP Router 是一个轻量级的 MCP 服务器,它本身不托管任何资源或工具,而是作为代理服务器,将 MCP 客户端的请求转发到远程 MCP 服务器(例如 MCP.so 提供的服务器)。通过 MCP Router,用户可以使用本地客户端访问远程 MCP 服务器的功能,实现更灵活的资源和工具管理。

主要功能点

  • 请求转发: 接收 MCP 客户端的资源、工具和 Prompt 请求,并转发到配置的远程 MCP 服务器。
  • 远程访问: 允许 MCP 客户端通过 MCP Router 访问远程 MCP 服务器托管的资源和工具。
  • 简化配置: 客户端只需配置 MCP Router,即可间接使用远程 MCP 服务器,简化了客户端配置。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的系统已安装 Node.js 和 npm。
  2. 下载仓库代码: 将 'mcp-server-router' 仓库的代码下载到本地。
  3. 安装依赖: 在仓库根目录下打开终端,运行以下命令安装项目依赖:
    npm install
  4. 构建项目: 运行以下命令构建项目:
    npm run build
    构建成功后,会在 'build' 目录下生成 'index.js' 文件,这就是服务器的入口文件。

服务器配置

MCP Router 需要通过环境变量 'SERVER_KEY' 来配置远程 MCP 服务器的密钥。你可以从远程 MCP 服务器提供商处获取 'SERVER_KEY'。

以下是 MCP 客户端(例如 Claude Desktop)的服务器配置示例,用于连接 MCP Router:

配置示例 (JSON 格式):

{
  "mcpServers": {
    "mcprouter": {
      "command": "node",
      "args": ["/path/to/mcprouter/build/index.js"],
      "env": {
        "SERVER_KEY": "YOUR_SERVER_KEY"  // 替换为你的远程 MCP 服务器密钥
      }
    }
  }
}

配置参数说明:

  • 'server name': 'mcprouter' (服务器名称,可以自定义)
  • 'command': 'node' (Node.js 运行命令)
  • 'args': '["/path/to/mcprouter/build/index.js"]' (MCP Router 服务器入口文件路径,请替换为实际路径)
  • 'env': 环境变量配置
    • 'SERVER_KEY': '"YOUR_SERVER_KEY"' (远程 MCP 服务器密钥,请务必替换为你的实际密钥)

Claude Desktop 配置文件路径:

  • MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
  • Windows: '%APPDATA%/Claude/claude_desktop_config.json'

将以上配置添加到 Claude Desktop 的配置文件中,并确保 'SERVER_KEY' 已正确配置。

基本使用方法

  1. 启动 MCP Router 服务器: 在配置好服务器配置后,当 MCP 客户端(如 Claude Desktop)尝试连接名为 'mcprouter' 的 MCP 服务器时,会自动启动 MCP Router。
  2. 客户端发起请求: 在 MCP 客户端中,像使用本地 MCP 服务器一样使用 'mcprouter' 服务器。MCP Router 会将请求转发到远程 MCP 服务器,并将响应返回给客户端。

调试: 如果遇到问题,可以使用 'npm run inspector' 命令启动 MCP Inspector 进行调试。

通过以上步骤,你就可以使用 MCP Router 作为代理,连接到远程 MCP 服务器,并在 MCP 客户端中使用远程服务器提供的资源和工具了。

信息

分类

网页与API