mcp-proxy

by tidewave-ai

A standalone binary for connecting STDIO-based MCP clients to HTTP (SSE) based MCP servers. The proxy supports SSE and streamable HTTP MCP protocols. No external data files are required.

Developer toolsstdioCommunity

Repository-wide counts · Cached 2026-03-07

Overview

The mcp-proxy MCP server is a publicly available project. Review the upstream repository for installation instructions, supported tools, compatibility, permissions, and current maintenance status.

Configuration

Configuration, transport, authentication, and runtime requirements vary by project. Open the repository before connecting and use the smallest set of credentials and permissions required.

Open the mcp-proxy repository to read the latest documentation.

KEEP EXPLORING

Compare source, connection, and authentication details before choosing an implementation.

View the complete category

模型上下文协议服务器

modelcontextprotocol

Community

一组用于模型上下文协议(MCP)的参考实现,展示了对大型语言模型(LLM)工具和数据源的安全且受控的访问方式。

Context7 Platform - Up-to-date Code Docs For Any Prompt

upstash

Community

Context7 MCP server providing up-to-date, version-specific documentation and code examples for libraries, enabling coding agents to fetch accurate docs and code snippets. Requires an API key for higher rate limits, passed via CONTEXT7_API_KEY header.

Playwright MCP

Microsoft Corporation

Community

A Model Context Protocol (MCP) server that provides browser automation capabilities using Playwright. Enables LLMs to interact with web pages through structured accessibility snapshots, bypassing the need for screenshots or visually-tuned models.

AIHawk

feder-cr

Community

AIHawk is an anti detect browser and web browsing agent, open source, with an MCP server for coding agents: undetected, no captchas, no blocks. It requires an OpenRouter API key for the standalone web UI mode, which can be provided via the --openrouter-key flag or the OPENROUTER_API_KEY environment variable or a .env file in the running directory.

FROM THE SOURCE

Repository README

Build-time snapshot · Retrieved 2026-10-05

View original

mcp-proxy

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.

Installation

The latest releases are available on the releases page.

macOS

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 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

which 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-proxy

Linux

You 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 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

You 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 .

Building from scratch

The proxy is built in Rust. If you have Rust and its tools installed, the project can be built with cargo:

cargo build --release

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

Usage

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.

On macos/Linux

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

On Windows

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

Configuration

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-time the maximum amount of time for trying to reconnect while disconnected. When not set, defaults to infinity.
  • --override-protocol-version to 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.