Skip to content
Back to search

mcp_proxy_rust

A proxy to use HTTP/SSE MCPs from STDIO clients

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tidewave-ai--mcp-proxy-rust/badge.svg)](/listings/tidewave-ai--mcp-proxy-rust)

HTML

<a href="/listings/tidewave-ai--mcp-proxy-rust"><img src="/api/listings/tidewave-ai--mcp-proxy-rust/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

The latest releases are available on the [releases page](https://github.com/tidewave-ai/mcp_proxy_rust/releases).

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](https://github.com/tidewave-ai/mcp_proxy_rust/releases) 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](https://github.com/tidewave-ai/mcp_proxy_rust/releases) 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 .

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 109 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # mcp-proxy
  2. A standalone binary for connecting STDIO based MCP clients to HTTP (SSE) based MCP servers.
  3. Note: the proxy supports both SSE according to the `2024-11-05` as well as streamable HTTP according to the `2025-03-26` specification.
  4. It may happen though that the connecting client does **not** support the version sent by the server.
  5. ## Installation
  6. The latest releases are available on the [releases page](https://github.com/tidewave-ai/mcp_proxy_rust/releases).
  7. ### macOS
  8. Depending on your Mac, you can download the latest version with one of the following commands:
  9. Apple Silicon:
  10. ```bash
  11. curl -sL https://github.com/tidewave-ai/mcp_proxy_rust/releases/latest/download/mcp-proxy-aarch64-apple-darwin.tar.gz | tar xv
  12. ```
  13. Intel:
  14. ```bash
  15. curl -sL https://github.com/tidewave-ai/mcp_proxy_rust/releases/latest/download/mcp-proxy-x86_64-apple-darwin.tar.gz | tar xv
  16. ```
  17. which will put the `mcp-proxy` binary in the current working directory (`pwd`).
  18. Note that the binaries are not notarized, so if you download the release with the browser, you won't be able to open it.
  19. Alternatively, you can remove the quarantine flag with:
  20. ```bash
  21. xattr -d com.apple.quarantine /path/to/mcp-proxy
  22. ```
  23. ### Linux
  24. You can download the latest release from the [Releases page](https://github.com/tidewave-ai/mcp_proxy_rust/releases) or with one command, depending on your architecture:
  25. x86:
  26. ```bash
  27. curl -sL https://github.com/tidewave-ai/mcp_proxy_rust/releases/latest/download/mcp-proxy-x86_64-unknown-linux-musl.tar.gz | tar zxv
  28. ```
  29. arm64 / aarch64:
  30. ```bash
  31. curl -sL https://github.com/tidewave-ai/mcp_proxy_rust/releases/latest/download/mcp-proxy-aarch64-unknown-linux-musl.tar.gz | tar zxv
  32. ```
  33. ### Windows
  34. You can download the latest release from the [Releases page](https://github.com/tidewave-ai/mcp_proxy_rust/releases) or with the following Powershell command:
  35. ```powershell
  36. 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 .
  37. ```
  38. ## Building from scratch
  39. The proxy is built in Rust. If you have Rust and its tools installed, the project can be built with `cargo`:
  40. ```bash
  41. cargo build --release
  42. ```
  43. Then, the binary will be located at `target/release/mcp-proxy`.
  44. ## Usage
  45. 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.
  46. ### On macos/Linux
  47. ```json
  48. {
  49. "mcpServers": {
  50. "my-server": {
  51. "command": "/path/to/mcp-proxy",
  52. "args": ["http://localhost:4000/tidewave/mcp"]
  53. }
  54. }
  55. }
  56. ```
  57. ### On Windows
  58. ```json
  59. {
  60. "mcpServers": {
  61. "my-server": {
  62. "command": "c:\\path\\to\\mcp-proxy.exe",
  63. "args": ["http://localhost:4000/tidewave/mcp"]
  64. }
  65. }
  66. }
  67. ```
  68. ## Configuration
  69. `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.
  70. Other supported flags:
  71. * `--max-disconnected-time` the maximum amount of time for trying to reconnect while disconnected. When not set, defaults to infinity.
  72. * `--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.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.