graph LR
    A["Claude Desktop"] <--> B["mcp-proxy"]
    B <--> C["External MCP Server"]

    style A fill:#ffe6f9,stroke:#333,color:black,stroke-width:2px
    style B fill:#e6e6ff,stroke:#333,color:black,stroke-width:2px
    style C fill:#e6ffe6,stroke:#333,color:black,stroke-width:2px

Tip

As of now, Claude Desktop does not support MCP servers that run on SSE transport. This server is a workaround to enable the support.

Installation

The stable version of the package is available on the PyPI repository. You can install it using the following command:

uv tool install mcp-proxy

The latest version of the package can be installed from the git repository using the following command:

uv tool install git+https://github.com/sparfenyuk/mcp-proxy

Note

If you have already installed the server, you can update it using uv tool upgrade --reinstall command.

Note

If you want to delete the server, use the uv tool uninstall mcp-proxy command.

Configuration

Claude Desktop Configuration

Configure Claude Desktop to recognize the MCP server.

Open the Claude Desktop configuration file:
- in MacOS, the configuration file is located at ~/Library/Application Support/Claude/claude_desktop_config.json
- in Windows, the configuration file is located at %APPDATA%\Claude\claude_desktop_config.json
Note: You can also find claude_desktop_config.json inside the settings of Claude Desktop app

Add the server configuration

{
  "mcpServers": {
    "mcp-proxy": {
        "command": "mcp-proxy",
        "env": {
          "SSE_URL": "http://example.io/sse"
        }
    }
  }
}

Advanced Configuration

Environment Variables

Name	Description
SSE_URL	The MCP server SSE endpoint to connect to e.g. http://example.io/sse
API_ACCESS_TOKEN	Added in the `Authorization` header of the HTTP request as a `Bearer` access token