local-mcp-proxy

A simple stdio-to-HTTP proxy for MCP (Model Context Protocol) servers.

Why?

Claude Desktop's Connector OAuth flow is currently broken (may be specific to custom connectors), which means you can't directly connect to JSON-RPC over HTTP MCP servers. This proxy works around that by exposing an HTTP-based MCP server over stdio, which Claude Desktop handles natively.

Building

go build -o mcp-proxy mcp-proxy.go

Usage

./mcp-proxy [--bearer <token>] [--debug] <url>

Arguments:

• url - The remote MCP server URL to proxy requests to (required)
• --bearer <token> - Bearer token for Authorization header (optional)
• --debug - Enable debug logging to stderr (optional)

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "/path/to/local-mcp-proxy/mcp-proxy",
      "args": [
        "--bearer",
        "your-token-here",
        "https://your-mcp-server.example.com/"
      ]
    }
  }
}

Or without authentication:

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "/path/to/local-mcp-proxy/mcp-proxy",
      "args": [
        "https://your-mcp-server.example.com/"
      ]
    }
  }
}