mcp-proxy 0.2.2

A MCP server which proxies requests to a remote MCP server over SSE transport.

mcp-proxy

• mcp-proxy
  • About
  • Installation
  • Configuration
    • Claude Desktop Configuration
  • Advanced Configuration
    • Environment Variables

About

Connect to MCP servers that run on SSE transport using the MCP Proxy server.

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

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.

1. 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

2. 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