通用 Stdio 集成允许任何支持 stdio 服务器的 MCP 客户端连接到 MetaMCP 的远程端点。由于 MetaMCP 端点是纯远程的（SSE、可流式 HTTP），您需要一个本地代理来桥接连接。

​
前置要求

在开始之前，请确保您拥有：
  • MCP 客户端支持 stdio 服务器（Claude Desktop、Cursor 等）
  • MetaMCP本地运行或已部署
  • 活动端点在 MetaMCP 中配置
  • API 密钥已生成（如果启用了身份验证）
  • mcp-proxy已安装（uvx mcp-proxy）

​
基本配置

​
使用 mcp-proxy（必需）

由于 MetaMCP 端点是纯远程的，您需要 mcp-proxy 来在 stdio 和 HTTP/SSE 协议之间进行转换。 
{
  "mcpServers": {
    "MetaMCP": {
      "command": "uvx",
      "args": [
        "mcp-proxy",
        "--transport",
        "streamablehttp",
        "http://localhost:12008/metamcp/your-endpoint-name/mcp"
      ],
      "env": {
        "API_ACCESS_TOKEN": "sk_mt_your_api_key_here"
      }
    }
  }
}

​
身份验证方法

​
故障排除

​
常见问题

  1. 连接被拒绝：确保 MetaMCP 正在运行且可访问
  2. 身份验证失败：验证 API 密钥是否正确且具有适当权限
  3. 找不到 mcp-proxy：使用 pip install mcp-proxy 或 uvx mcp-proxy 安装

​
调试模式

为 mcp-proxy 启用调试日志： 
{
  "mcpServers": {
    "MetaMCP": {
      "command": "uvx",
      "args": [
        "mcp-proxy",
        "--transport",
        "streamablehttp",
        "--debug",
        "http://localhost:12008/metamcp/your-endpoint-name/mcp"
      ],
      "env": {
        "API_ACCESS_TOKEN": "sk_mt_your_api_key_here"
      }
    }
  }
}

​
重要说明

  • 替换 your-endpoint-name 为您的实际端点名称
  • 替换 sk_mt_your_api_key_here 为您的 MetaMCP API 密钥
  • mcp-proxy 处理 stdio 和可流式 HTTP/SSE 之间的协议转换
  • 环境变量是传递 API 密钥的安全方式