mcp-proxy

by tidewave-ai

Not rated
GitHub

About

A standalone proxy to connect STDIO-based MCP clients with HTTP (SSE) based MCP servers.

Details

Author
tidewave-ai
Categories
Communication, API, Developer Tools

Setup

Install mcp-proxy in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/tidewave-ai/mcp_proxy_rust

Follow the installation instructions in the repository README, then restart your MCP client.

A standalone binary for connecting STDIO based MCP clients to HTTP (SSE) based MCP servers.

Note: the proxy supports both SSE according to the2024-11-05as well as streamable HTTP according to the2025-03-26specification. It may happen though that the connecting client doesnotsupport the version sent by the server.

The latest releases are available on thereleases page.

Depending on your Mac, you can download the latest version with one of the following commands:

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

which will put themcp-proxybinary 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-proxy

You can download the latest release from theReleases pageor with one command, depending on your architecture:

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

You can download the latest release from theReleases pageor 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 withcargo:

Then, the binary will be located attarget/release/mcp-proxy.

If you have an SSE MCP server available athttp://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-proxyeither accepts the SSE URL as argument or using the environment variableSSE_URL. For debugging purposes, you can also pass--debug, which will log debug messages on stderr.

- --max-disconnected-timethe maximum amount of time for trying to reconnect while disconnected. When not set, defaults to infinity.
- --override-protocol-versionto override the protocol version reported by the proxy. This is useful when using the proxy with a client that expects a different protocol version, when the only reason for mismatching protocols is the use of streamable / SSE transports.

Send and receive transactional email through Nuntly, a developer-first email platform with EU data hosting. Tools covering emails, domains, webhooks, inboxes, and threads.

Enables seamless integration with communication platform that allows you to reach your customers globally across any channel.

Interact with any other SaaS applications on behalf of your customers.

Official MCP Server to interact with Pearl API. Connect your AI Agents with 12,000+ certified experts instantly.

Platfone - Receive SMS & Virtual Numbers MCP

Virtual phone number platform for AI agents — rent numbers across 200+ countries, receive SMS, and manage the full activation lifecycle

Send emails directly from your editor using the Resend API.

Sendmux is an email inbox API and email API for AI agents.

Sinch Engage (Sinch MessageMedia in AU) MCP server, which provides Sinch Engage APIs as MCP tools.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.