What is mcp-proxy?
mcp-proxy is a tool that lets you switch between MCP server transports, supporting two modes: stdio to SSE and SSE to stdio. It is intended for developers using MCP clients like Claude Desktop who need to connect to remote SSE servers or expose local stdio servers over SSE.
How to use mcp-proxy?
Install via PyPI (uv tool install mcp-proxy or pipx install mcp-proxy) or as a Docker container. To run in stdio-to-SSE mode, pass the SSE endpoint URL and optional headers. For SSE-to-stdio mode, use the --sse-port flag and the command for the local stdio server. Configuration is done in the MCP client’s settings (e.g., Claude Desktop’s mcpServers JSON).
Key features of mcp-proxy
- Converts stdio transport to SSE transport
- Converts SSE transport to stdio transport
- Supports custom HTTP headers for SSE connections
- Allows passing environment variables to spawned servers
- Supports CORS configuration for SSE server
- Available as a Python package and Docker image
Use cases of mcp-proxy
- Connect Claude Desktop to a remote MCP server over SSE
- Expose a local stdio-based MCP server to remote clients via SSE
- Test MCP servers with the inspector tool using a proxy
- Run MCP servers behind a proxy with custom ports and hosts
评论