A standalone binary for connecting STDIO based MCP clients to HTTP (SSE) based MCP servers.
Note: the proxy supports both SSE according to the 2024-11-05 as well as streamable HTTP according to the 2025-03-26 specification.
It may happen though that the connecting client does not support the version sent by the server.
The latest releases are available on the releases page.
Depending on your Mac, you can download the latest version with one of the following commands:
Apple Silicon:
curl -sL https://github.com/tidewave-ai/mcp_proxy_rust/releases/latest/download/mcp-proxy-aarch64-apple-darwin.tar.gz | tar xvIntel:
curl -sL https://github.com/tidewave-ai/mcp_proxy_rust/releases/latest/download/mcp-proxy-x86_64-apple-darwin.tar.gz | tar xvwhich will put the mcp-proxy binary in the current working directory (pwd).
Note that the binaries are not notarized, so if you download the release with the browser, you won't be able to open it.
Alternatively, you can remove the quarantine flag with:
xattr -d com.apple.quarantine /path/to/mcp-proxyYou can download the latest release from the Releases page or with one command, depending on your architecture:
x86:
curl -sL https://github.com/tidewave-ai/mcp_proxy_rust/releases/latest/download/mcp-proxy-x86_64-unknown-linux-musl.tar.gz | tar zxvarm64 / aarch64:
curl -sL https://github.com/tidewave-ai/mcp_proxy_rust/releases/latest/download/mcp-proxy-aarch64-unknown-linux-musl.tar.gz | tar zxvYou can download the latest release from the Releases page or with the following Powershell command:
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 .The proxy is built in Rust. If you have Rust and its tools installed, the project can be built with cargo:
cargo build --releaseThen, the binary will be located at target/release/mcp-proxy.
If you have an SSE MCP server available at http://localhost:4000/tidewave/mcp, a client like Claude Desktop would then be configured as follows.
{
"mcpServers": {
"my-server": {
"command": "/path/to/mcp-proxy",
"args": ["http://localhost:4000/tidewave/mcp"]
}
}
}{
"mcpServers": {
"my-server": {
"command": "c:\\path\\to\\mcp-proxy.exe",
"args": ["http://localhost:4000/tidewave/mcp"]
}
}
}mcp-proxy either accepts the SSE URL as argument or using the environment variable SSE_URL. For debugging purposes, you can also pass --debug, which will log debug messages on stderr.
Other supported flags:
--max-disconnected-timethe maximum amount of time for trying to reconnect while disconnected. When not set, defaults to infinity.