MCP Catalogs
Home

mcp-proxy

by sparfenyuk·2,520·Score 55

MCP proxy that bridges stdio and SSE/StreamableHTTP transports for connecting MCP servers.

developer-toolsai-llmops-infra
235
Forks
41
Open issues
this month
Last commit
2d ago
Indexed

Overview

The mcp-proxy is a transport bridge for MCP servers, enabling connections between stdio and SSE/StreamableHTTP protocols. It allows clients like Claude Desktop to communicate with remote SSE servers that aren't natively supported. The tool operates in two modes: stdio to SSE/StreamableHTTP (for local clients to connect to remote servers) and SSE to stdio (for remote clients to connect to local servers). It supports authentication, CORS configuration, and named servers with comprehensive command-line options.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

you:Enabling Claude Desktop to connect to remote MCP servers over SSE
you:Making local MCP servers accessible via web interfaces through SSE
you:Connecting MCP servers that use different transport protocols
you:What transport protocols does mcp-proxy support?
you:How do I set up authentication for the SSE server?

When to choose this

Choose this when you need to connect MCP clients that only support stdio transport with remote MCP servers using SSE/StreamableHTTP, or when you want to expose local MCP servers to remote clients.

When NOT to choose this

Avoid if you need direct communication between stdio-only MCP servers and clients without the proxy layer, or if you require WebSocket transport which is not supported.

Comparable tools

nomic-ai/cloudflare-mcpmicrosoft/vscode-mcpdeepmind/client-mcp

Installation

Installation

Via PyPI

pip install mcp-proxy

From GitHub

git clone https://github.com/sparfenyuk/mcp-proxy.git
cd mcp-proxy
pip install -e .

Using Docker

docker pull sparfenyuk/mcp-proxy:latest

Claude Desktop Configuration

{
  "mcpServers": {
    "mcp-proxy": {
      "command": "mcp-proxy",
      "args": [
        "http://example.io/sse"
      ],
      "env": {
        "API_ACCESS_TOKEN": "access-token"
      }
    }
  }
}

FAQ

What transport protocols does mcp-proxy support?
mcp-proxy supports two transport protocols: SSE (Server-Sent Events) and StreamableHTTP, bridging between these and stdio connections.
How do I set up authentication for the SSE server?
You can use the --headers argument with Authorization token, or set API_ACCESS_TOKEN environment variable. For OAuth2, use --client-id, --client-secret, and --token-url options.

Compare mcp-proxy with

GitHub →

Last updated · Auto-generated from public README + GitHub signals.