Автономный бинарный файл для подключения MCP-клиентов на основе STDIO к MCP-серверам на базе HTTP (SSE).

Примечание: прокси поддерживает как SSE согласно 2024-11-05, так и потоковый HTTP согласно спецификации 2025-03-26. Однако может случиться, что подключающий клиент не поддерживает версию, отправленную сервером.

Установка

Последние релизы доступны на странице релизов.

macOS

В зависимости от вашего Mac, вы можете скачать последнюю версию с помощью одной из следующих команд:

Apple Silicon:

Информация:

что поместит двоичный файл mcp-proxy в текущий рабочий каталог (pwd).

Обратите внимание, что бинарные файлы не заверены нотариально, поэтому если скачать релиз через браузер, вы не сможете его открыть.

В качестве альтернативы можно убрать флаг карантина следующим образом:

Linux

Вы можете скачать последний релиз со страницы релизов или с помощью одной команды, в зависимости от вашей архитектуры:

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