mcp-proxy

一个独立的二进制程序，用于连接基于STDIO的MCP客户端到基于HTTP（SSE）的MCP服务器。

注意：该代理支持根据2024-11-05规范的SSE以及根据2025-03-26规范的流式HTTP。不过，连接的客户端可能不支持服务器发送的版本。

安装

最新版本可以在发布页面找到。

macOS

根据你的Mac型号，可以使用以下命令之一下载最新版本：

Apple Silicon：

curl -sL https://github.com/tidewave-ai/mcp_proxy_rust/releases/latest/download/mcp-proxy-aarch64-apple-darwin.tar.gz | tar xv

Intel：

curl -sL https://github.com/tidewave-ai/mcp_proxy_rust/releases/latest/download/mcp-proxy-x86_64-apple-darwin.tar.gz | tar xv

这将会把mcp-proxy二进制文件放置在当前工作目录中（pwd）。

请注意，这些二进制文件没有经过公证，因此如果你通过浏览器下载发布版本，将无法打开它。

另外，你可以移除隔离标志：

xattr -d com.apple.quarantine /path/to/mcp-proxy

Linux

你可以从发布页面下载最新版本，或者根据你的架构使用以下命令之一：

x86：

curl -sL https://github.com/tidewave-ai/mcp_proxy_rust/releases/latest/download/mcp-proxy-x86_64-unknown-linux-musl.tar.gz | tar zxv

arm64 / aarch64：

curl -sL https://github.com/tidewave-ai/mcp_proxy_rust/releases/latest/download/mcp-proxy-aarch64-unknown-linux-musl.tar.gz | tar zxv

Windows

你可以从发布页面下载最新版本，或者使用以下Powershell命令：

curl.exe -L -o mcp-proxy.zip https://github.com/tidewave-ai/mcp_proxy_rust/releases/latest/download/mcp-proxy-x86_64-pc-windows-msvc.zip; Expand-Archive -Path mcp-proxy.zip -DestinationPath .

从零开始构建

该代理是用Rust编写的。如果你安装了Rust及其工具，可以通过cargo构建项目：

cargo build --release

然后，二进制文件将位于target/release/mcp-proxy。

使用方法

如果你有一个可用的SSE MCP服务器，地址为http://localhost:4000/tidewave/mcp，那么像Claude Desktop这样的客户端可以按如下方式配置。

在macOS/Linux上

{
  "mcpServers": {
    "my-server": {
      "command": "/path/to/mcp-proxy",
      "args": ["http://localhost:4000/tidewave/mcp"]
    }
  }
}

在Windows上

{
  "mcpServers": {
    "my-server": {
      "command": "c:\\path\\to\\mcp-proxy.exe",
      "args": ["http://localhost:4000/tidewave/mcp"]
    }
  }
}

配置

mcp-proxy接受SSE URL作为参数或使用环境变量SSE_URL。为了调试目的，你也可以传递--debug，这将在stderr中记录调试消息。

其他支持的标志：

• --max-disconnected-time 当断开连接时尝试重新连接的最大时间。未设置时默认为无穷大。
• --override-protocol-version 覆盖代理报告的协议版本。当使用与期望不同协议版本的客户端时，此选项非常有用，特别是当唯一的原因是使用流式/ SSE传输时。