mcp-proxy

What is mCP-Proxy?

mcp-proxy is a Rust bidirectional proxy for the Model Context Protocol that supports SSE and Streamable HTTP transports with OAuth authentication. It is designed for developers who need to connect remote MCP servers to local clients or expose local servers remotely.

How to use mCP-Proxy?

Install via cargo install rmcp-proxy or build from source. Run in remote client mode to connect to a remote server and expose it as a local stdio server, or in local server mode to connect to a local stdio server and expose it as a remote server. Transport is auto-detected (URLs with /sse use SSE; others use Streamable HTTP) or can be overridden with --transport.

Key features of mCP-Proxy

• Multiple transports: SSE and Streamable HTTP
• Full OAuth authentication with automatic token refresh
• Bidirectional proxy (remote to local and local to remote)
• Fast and lightweight, built in Rust

Use cases of mCP-Proxy

• Use a remote MCP server as a local stdio server in Claude or Cursor
• Expose a local MCP server over the network via SSE or Streamable HTTP
• Connect to MCP servers that require OAuth authentication
• Proxy MCP traffic between different transport types

FAQ from mCP-Proxy

What transports does mcp-proxy support?

SSE (Server-Sent Events) and Streamable HTTP.

How does transport detection work?

If the URL contains /sse, SSE is used; all other URLs use Streamable HTTP. You can override with the --transport flag.

How do I clear authentication data?

Use mcp-proxy reset or manually delete the ~/.mcp-auth directory.

What runtime does mcp-proxy require?

Rust and Cargo (install via cargo install rmcp-proxy or build from source with cargo build --release).

How can I control logging verbosity?

Set the RUST_LOG environment variable (e.g., RUST_LOG=error for minimal logging).