MCP Kit Local Relay

MCP Kit Local Relay

此命令行工具充当桥接程序，让使用标准输入/输出（stdio）的本地 MCP 客户端（如 Claude Desktop）能够与您通过 MCP Kit Web App 配置的远程 MCP 服务交互。

它一次仅代理到一个目标服务，并在本地提供该服务的工具和资源。

入门指南（以 Claude Desktop 为例）

按照以下步骤，通过此中继将 Claude Desktop 连接到您的远程 MCP 服务：

前置条件：

• Node.js（推荐 v18 或更高版本）
• Node.js
• Git

步骤：

1. 克隆中继： 如果您尚未克隆此仓库，请先克隆并进入该目录：

   git clone https://github.com/trevoruptain/mcp-local-relay
   cd local-relay
   

2. 安装依赖项：

   npm install
   

3. 配置中继： 在 local-relay 文件夹中直接创建两个配置文件：

   • .env 文件： 创建此文件并添加您的 MCP Kit API 密钥。您可以在此处生成 API 密钥。

     # 在 MCP Kit Web App (app.mcpkit.ai) -> API Keys 中获取您的 API 密钥
     MCPKIT_API_KEY=your_api_key_here
     

     （将 your_api_key_here 替换为您的实际密钥）

   • mcpconfig.json 文件： 创建此文件，并指定您希望此中继连接的_单个_远程 MCP 服务的唯一 ID。

     {
       "targetServerId": "your_target_server_id_here"
     }
     

     （将 your_target_server_id_here 替换为 MCP Kit Web App -> Servers 页面上显示的 Server ID）

4. 构建中继： 编译代码：

   npm run build
   

   这会创建一个包含所需 JavaScript 文件的 dist 目录。主脚本是 dist/index.js。

5. 配置 Claude Desktop： 您需要告知 Claude Desktop 如何运行中继脚本。

   • 打开 Claude Desktop 设置（菜单 -> Settings... -> Developer -> Edit Config）。
   • 编辑 claude_desktop_config.json 文件。
   • 在 mcpServers 下添加一个条目。将 node 设为 command，并在 args 中提供刚才构建的 dist/index.js 文件的完整绝对路径。

   {
     "mcpServers": {
       "my_mcp_server": {
         // 选择一个供 Claude Desktop 显示的名称
         "command": "node",
         "args": [
           // 将此处替换为*绝对*路径！
           "/Users/yourname/path/to/local-relay/dist/index.js"
         ]
       }
     }
   }
   

   • 重要： 将示例路径替换为您系统上的实际绝对路径。
   • 有关编辑 Claude 配置的详细说明，请参阅本地中继文档。（注意：如果最终 URL 不同，请更新此链接）

6. 重启 Claude Desktop： 完全退出并重新启动 Claude Desktop 应用程序。

7. 验证： 点击 Claude Desktop 聊天输入框中的锤子图标 。您应该能在所选名称（例如 my_mcp_server）下看到目标服务提供的工具。

现在，您可以直接在 Claude Desktop 中使用远程 MCP 服务的工具了！

手动运行中继

您也可以直接从终端运行中继（例如，用于测试或配合其他 stdio 客户端使用）：

npm start

此命令会执行 node --stack-size=32768 dist/index.js。中继将开始通过标准输入监听 MCP 命令。加入 --stack-size 标志是为了防止处理大型资源（如图像）时可能出现的 "Maximum call stack size exceeded" 错误。

故障排除

• Claude Desktop 问题：
  • 锤子图标未显示或未列出工具？
  • 仔细检查 claude_desktop_config.json 中 dist/index.js 的绝对路径。
  • 确认 npm run build 已成功完成，没有错误。
  • 确保 .env 和 mcpconfig.json 存在于 local-relay 目录中，并包含正确的 API 密钥和 Server ID。
  • 查看 Claude Desktop 自身的日志（日志位置请参见官方 MCP 文档）。
• 中继错误：
  • 查看 local-relay 目录中生成的 local-relay-debug.log 文件，了解中继本身的详细错误信息。
  • 确保 .env 中的 MCP_SERVER_URL（或默认值 http://localhost:3002）指向正在运行的 mcp-kit-server 实例。
  • 确认你的 MCPKIT_API_KEY 有效。

开发

要在开发模式下运行中继，并在代码更改时自动重启：

npm run dev

这会使用 nodemon 和 ts-node。

贡献

欢迎贡献！请参阅 CONTRIBUTING.md 了解相关指南。

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。