MC

mcp-proxy

Created 6 months ago

mcp-proxy is a tool that lets you switch between server transports.

development documentation public

What is mcp-proxy?

Connect to MCP servers that run on SSE transport, or expose stdio servers as an SSE server.

Documentation

mcp-proxy

About

The mcp-proxy is a tool that lets you switch between server transports. There are two supported modes: 1. stdio to SSE/StreamableHTTP 2. SSE to stdio

Installation# Installing via Smithery

To install MCP Proxy for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install mcp-proxy --client claude
```\n\n### Installing via PyPI
The stable version of the package is available on the PyPI repository. You can install it using the following command:
```bash\n\n# Option 1: With uv (recommended)
uv tool install mcp-proxy\n\n# Option 2: With pipx (alternative)
pipx install mcp-proxy
```\n\n### Installing via Github repository (latest)
The latest version of the package can be installed from the git repository using the following command:
```bash
uv tool install git+https://github.com/sparfenyuk/mcp-proxy
```\n\n### Troubleshooting
- **Problem**: Claude Desktop can't start the server: ENOENT code in the logs
**Solution**: Try to use the full path to the binary.

## Command line arguments
```bash
usage: mcp-proxy [-h] [--version] [-H KEY VALUE] [--transport {sse,streamablehttp}] [-e KEY VALUE] [--cwd CWD] [--pass-environment | --no-pass-environment] [--debug | --no-debug] [--named-server NAME COMMAND_STRING] [--named-server-config FILE_PATH] [--port PORT] [--host HOST] [--stateless | --no-stateless] [--sse-port SSE_PORT] [--sse-host SSE_HOST] [--allow-origin ALLOW_ORIGIN [ALLOW_ORIGIN ...]] [command_or_url] [args ...]

Server Config

{
  "mcpServers": {
    "mcp-proxy-server": {
      "command": "npx",
      "args": [
        "mcp-proxy"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: No

Project Info

Hosted Featured
Created At: May 23, 2025
Updated At: Aug 07, 2025
Author: sparfenyuk
Category: community
License: MIT
Tags:
development documentation public