🚀 MCP2HTTP

MCP2HTTP是一个最小化的传输适配器，它能让使用标准输入输出（stdio）的MCP客户端与无状态的HTTP MCP服务器建立连接，为MCP协议的应用拓展了新的可能性。

🚀 快速开始

MCP2HTTP可使模型上下文协议客户端，通过stdio传输与使用HTTP通信的MCP服务器建立连接。即便MCP通常采用stdio（用于本地进程）或Server-Sent Events（SSE）传输，此适配器也能将其桥接到常规的HTTP端点，实现新的集成。该适配器仅处理基本的传输层转换，并通过客户端生成的唯一标识符Session-Id头提供可选的状态跟踪，保留协议语义，让客户端和服务器直接交互，无需使用SSE，能与无服务器平台和遗留系统无缝协作。

✨ 主要特性

客户端生成的会话跟踪

• 适配器会自动生成唯一标识符（UUID），并将其作为Session-Id头包含在每个请求中。这种客户端生成会话ID的方式类似于1996年提出的Session-Id提案（未正式纳入HTTP标准），简单实用，旨在补充（而非替代）适当的身份验证。
• 128位十六进制UUID格式具备抗碰撞能力，利用了普遍的标识符标准，非常适合在无状态的HTTP环境中关联请求。为防止碎片化并确保行为一致，符合此设计的服务器实现应拒绝非128位十六进制Session-Id值（带或不带破折号）。若不需要会话跟踪，服务器可完全忽略Session-Id头。该功能可选，方便那些仅需请求间相关性而不想增加额外复杂性的实现。

能力过滤

• 适配器会从initialize响应中记录服务器的功能，并阻止对未声明能力的请求。这解决了某些MCP客户端每分钟多次重复轮询未广告能力的问题。通过在请求到达服务器之前进行筛选，当服务器仅支持特定功能（如tools），而客户端仍持续静默轮询时，可减少不必要的负载。

通知处理

• 无ID的消息（通知）会被默默地丢弃。这种处理方式与HTTP的请求/响应架构自然契合。在MCP通过无状态HTTP实现时，丢弃通知是合理选择，这也是像mcp-golang HTTP传输等其他实现得出的结论。尽管notifications/initialized可能会引人关注，但处理通知的一致性带来的实际好处更为重要。不过，HTTP MCP服务器仍可选择优雅地处理通知，以防其他实现确实转发它们。

💻 使用示例

基础用法

配置您的MCP客户端以以下格式调用此命令：

npx -y mcp2http <endpoint-url> ["Header: Value"...]

例如，在Claude Desktop配置文件（claude_desktop_config.json）中：

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp2http",
        "http://localhost:3000/mcp"
      ]
    }
  }
}

高级用法

您还可以添加任意数量的HTTP头作为参数。例如，要包含一个身份验证令牌：

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp2http",
        "https://example.com/mcp",
        "Authorization: Bearer token123"
      ]
    }
  }
}

⚠️ 重要提示

您需要一个功能正常的MCP HTTP端点。很快将提供一个示例服务器。

📄 许可证

本项目采用MIT许可证。