STDIO 기반 MCP 클라이언트를 HTTP(SSE) 기반 MCP 서버에 연결하는 독립 실행형 바이너리입니다.

참고: 프록시는 2024-11-05에 따른 SSE와 2025-03-26 사양에 따른 스트리밍 가능한 HTTP를 모두 지원합니다. 하지만 연결된 클라이언트가 서버에서 보내는 버전을 지원하지 않는 경우도 있습니다.

설치

최신 출시 정보는 출시 페이지에서 확인할 수 있습니다.

macOS

Mac에 따라 다음 명령어 중 하나로 최신 버전을 다운로드할 수 있습니다:

애플 실리콘:

인텔:

이렇게 하면 mcp-proxy 이진이 현재 작업 디렉터리(pwd)에 저장됩니다.

참고로 바이너리는 공증되지 않아, 브라우저로 릴리스를 다운로드하면 열지 못합니다.

또는 격리 플래그를 제거하면 다음과 같은 방법이 있습니다:

리눅스

최신 릴리스는 Releases 페이지에서 다운로드하거나 아키텍처에 따라 한 가지 명령어로 다운로드할 수 있습니다:

x86:

arm64 / aarch64:

창문

최신 릴리스는 릴리스 페이지에서 다운로드하거나 다음 Powershell 명령어를 사용해 다운로드할 수 있습니다:

처음부터 쌓아

프록시는 Rust로 빌드되었습니다. Rust와 그 도구들이 설치되어 있다면, cargo로 프로젝트를 구축할 수 있습니다:

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