MCP Kit Local Relay
2025.05.05
0
TypeScriptMCP 桥接工具本地-远程代理开发效率
MCP Kit Local Relay 是一个命令行工具，作为本地 MCP 客户端（如 Claude Desktop）与远程 MCP 服务器之间的桥梁。它通过标准输入/输出（`stdio`）协议工作，允许本地客户端访问远程 MCP 服务器的工具和资源。该工具一次只能代理一个目标服务器，适合需要将远程 MCP 服务器功能集成到本地开发环境的场景。
View on GitHub
Overview
基本能力
产品定位
MCP Kit Local Relay 是一个桥接工具，用于连接本地 MCP 客户端和远程 MCP 服务器，使本地客户端能够访问远程服务器的工具和资源。
核心功能
- 作为本地 MCP 客户端与远程 MCP 服务器之间的代理
- 支持标准输入/输出（
stdio）协议 - 一次只能代理一个目标服务器
- 提供配置文件和 API 密钥管理
- 支持开发模式和自动重启
适用场景
- 在 Claude Desktop 等本地 MCP 客户端中使用远程 MCP 服务器的工具
- 开发环境中需要访问远程 MCP 服务器资源
- 测试和调试 MCP 服务器功能
工具列表
node- 运行 JavaScript 代码npm- Node.js 包管理器git- 版本控制工具
常见问题解答
- Claude Desktop 问题：
- 如果锤子图标缺失或工具未列出，请检查
claude_desktop_config.json中的绝对路径 - 确保
npm run build完成且无错误 - 检查
.env和mcpconfig.json文件是否存在且包含正确的 API 密钥和服务器 ID - Relay 错误：
- 检查
local-relay-debug.log文件中的详细错误信息 - 确保
.env中的MCP_SERVER_URL指向正在运行的mcp-kit-server实例 - 确认
MCPKIT_API_KEY有效
使用教程
使用依赖
- Node.js（推荐 v18 或更高版本）
- Git
安装教程
- 克隆仓库并进入目录：
bash git clone https://github.com/trevoruptain/mcp-local-relay cd local-relay - 安装依赖：
bash npm install - 创建配置文件
.env和mcpconfig.json - 构建项目：
bash npm run build - 配置 Claude Desktop 的
claude_desktop_config.json文件 - 重启 Claude Desktop
调试方式
- 手动运行 relay：
bash npm start - 开发模式（自动重启）：
bash npm run dev - 查看日志文件：
local-relay-debug.log