MCPProxy

选型与风险

安装接入

{
  "mcpServers": {
    "MCPProxy": {
      "type": "http",
      "url": "http://localhost:8080/mcp/"
    }
  }
}

{
  "servers": {
    "MCPProxy": {
      "type": "http",
      "url": "http://localhost:8080/mcp/"
    }
  }
}

claude mcp add --transport http MCPProxy http://localhost:8080/mcp/

验证是否装好

运行 mcpproxy serve 后，在客户端配置 http://localhost:8080/mcp/ 并确认工具列表中出现 retrieve_tools、describe_tool 等内置工具；或用 mcpproxy activity list 确认调用记录。

常见排障

1. 客户端连不上：确认 mcpproxy serve 已运行、端口 8080 未被占用，并用 curl http://localhost:8080/api/v1/status 检查服务状态
2. HTTPS 连接失败：先启用 TLS（MCPPROXY_TLS_ENABLED=true 或 tls.enabled），运行 mcpproxy trust-cert --force 重新信任证书，并确认 ~/.mcpproxy/certs/ 下存在 ca.pem、server.pem、server-key.pem
3. Claude Desktop 报证书错误：确保 NODE_EXTRA_CA_CERTS 指向正确的 ca.pem，并在此之后重启 Claude Desktop
4. 代理找不到工具：新服务器默认被隔离，需要在 Web UI 或安全命令中审批；同时检查 mcp_config.json 中 enabled 是否为 true
5. 自动化任务失败：用 mcpproxy tools preflight 检查；退出码 10 表示瞬时问题（服务器正在启动），11 表示被阻断需人工处理，12 表示工具 id 拼写或配置错误
6. 排查代理行为：用 mcpproxy serve --log-level=debug 提高日志级别，并用 mcpproxy activity list --request-id <id> 关联单次工作流的全部调用

试试这样问

连接成功后，可以直接对 AI 助手这样说：

• 检索能创建 GitHub issue 的工具，列出前 5 个复制
• 用 describe_tool 查看 github:create_issue 的完整参数复制
• 通过 call_tool_write 在 acme/api 仓库提交一条标题为 Bug report 的 issue复制
• 查看最近的活动日志，列出刚才 agent 调用过哪些工具复制

工具能力 5

没有匹配的工具

使用场景

支持客户端

依据项目文档列出，未经本站实测。

详细介绍

同类可选方案