mcp-proxy logo

mcp-proxy

by juhemcp

The `mcp-proxy` is a tool that lets you switch between server transports, supporting stdio to SSE and SSE to stdio modes. It enables communication between clients and servers with different transport protocols.

View on GitHub

Last updated: N/A

What is mcp-proxy?

mcp-proxy is a versatile proxy server that facilitates communication between applications using different transport protocols. It supports two main modes: converting standard input/output (stdio) to Server-Sent Events (SSE) and vice versa.

How to use mcp-proxy?

The mcp-proxy can be installed via Smithery, PyPI, GitHub, or as a container. Configuration depends on the chosen mode. For stdio to SSE, provide the SSE server URL. For SSE to stdio, specify the SSE port and the command to run the local stdio server. Command-line arguments and environment variables can be used to customize the proxy's behavior.

Key features of mcp-proxy

  • stdio to SSE conversion

  • SSE to stdio conversion

  • Flexible configuration options

  • Docker container support

  • Command-line argument customization

Use cases of mcp-proxy

  • Enabling Claude Desktop to communicate with remote SSE servers

  • Allowing remote connections to local stdio servers

  • Bridging applications with incompatible transport protocols

  • Creating custom container images with additional executables

FAQ from mcp-proxy

What is mcp-proxy?

mcp-proxy is a tool that lets you switch between server transports. There are two supported modes: stdio to SSE and SSE to stdio.

How do I install mcp-proxy?

You can install mcp-proxy via Smithery, PyPI, GitHub, or as a Docker container.

How do I configure mcp-proxy for stdio to SSE?

Pass the URL to the MCP Server SSE endpoint as the first argument to the program. You can also use the --headers argument or the API_ACCESS_TOKEN environment variable for authentication.

How do I configure mcp-proxy for SSE to stdio?

Set the --sse-port argument. The --sse-host argument can be set to specify the host IP address that the SSE server will listen on. Pass the command line arguments for the local stdio server after the -- separator.

How do I test mcp-proxy?

Run it with the mcp-server-fetch server and use the inspector tool to test the target server.