mcp-proxy
About This Server
Connect to MCP servers that run on SSE transport, or expose stdio servers as an SSE server using the MCP Proxy server.
Server Information
The webpage is a GitHub repository for a project called "mcp-proxy." This project provides a tool to switch between server transports, specifically between stdio and Server-Sent Events (SSE) for Model Context Protocol (MCP) servers. It supports two modes: stdio to SSE and SSE to stdio. The repository includes installation instructions, configuration details, usage examples, and information on extending the container image and Docker Compose setup.
ā Key Points:
* The project facilitates communication between MCP clients and servers using different transport mechanisms (stdio and SSE).
* It offers two primary modes: stdio to SSE (for clients like Claude Desktop that don't natively support SSE) and SSE to stdio (for remote connections to local stdio servers).
* The repository provides comprehensive installation instructions using Smithery, PyPI, Github repository, and as a container.
* Configuration details and command-line arguments are clearly outlined for both modes of operation.
š Main Findings:
* The mcp-proxy tool acts as an intermediary, translating between stdio and SSE protocols for MCP communication.
* The repository is well-documented, including usage examples and setup instructions for different scenarios.
* The project offers flexibility in deployment, with options for installing via package managers, directly from the repository, or as a container.
* The tool supports configuration through command-line arguments and environment variables.
š Details:
* Modes of Operation:
* stdio to SSE: Clients connect to the proxy via stdio, which then communicates with an external SSE-based MCP server.
* Requires the URL of the MCP server SSE endpoint as an argument.
* Supports passing headers for SSE connections.
* SSE to stdio: Exposes an SSE server, relaying requests to a local stdio-based MCP server.
* Requires the `--sse-port` argument and allows configuration of host IP and environment variables.
* Installation:
* Smithery: `npx -y @smithery/cli install mcp-proxy --client claude`
* PyPI: `uv tool install mcp-proxy` or `pipx install mcp-proxy`
* Github repository: `uv tool install git+https://github.com/sparfenyuk/mcp-proxy`
* Container: `docker run -t ghcr.io/sparfenyuk/mcp-proxy:v0.3.2-alpine --help`
* Extending the Container Image: Shows how to add `uv` to the Docker image.
* Command-Line Arguments: Details available arguments for both stdio to SSE and SSE to stdio modes.
* Testing: Instructions available to check `mcp-proxy` with `mcp-server-fetch`.
šÆ Conclusion:
The "mcp-proxy" project on GitHub provides a valuable utility for adapting MCP servers to different transport protocols. Its comprehensive documentation and flexible installation options make it a useful tool for developers working with MCP-based applications.
Server Features
stdio to SSE
Run a proxy server from stdio that connects to a remote SSE server. This mode allows clients like Claude Desktop to communicate to a remote server over SSE even though it is not supported natively.
SSE to stdio
Run a proxy server exposing a SSE server that connects to a local stdio server. This allows remote connections to the local stdio server. The mcp-proxy opens a port to listen for SSE requests, spawns a local stdio server that handles MCP requests.
Provider Information
Sparfenyuk
cloud Provider