MCP HTTP Proxy

A lightweight proxy that enables STDIO-based MCP clients (like Claude Desktop, Cline, LM Studio) to connect to HTTP-based MCP servers.

Problem

Many MCP clients only support STDIO transport, but you want to connect to remote MCP servers running over HTTP (like Cloud Run deployments).

Solution

This tiny proxy bridges the gap:

• Accepts JSON-RPC messages via STDIO
• Forwards them to your HTTP MCP server
• Returns responses back via STDIO

Installation & Usage

With npx (recommended)

npx mcp-http-proxy https://your-mcp-server.com/mcp

In Claude Desktop / Cline Config

{
  "mcpServers": {
    "my-server": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-http-proxy",
        "https://your-mcp-server.com/mcp"
      ]
    }
  }
}

Example: Perplexity on Cloud Run

{
  "mcpServers": {
    "perplexity": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-http-proxy",
        "https://mcp-perplexity-37svygdpla-uc.a.run.app/mcp"
      ]
    }
  }
}

Features

• ✅ Zero dependencies
• ✅ Works with any HTTP MCP server
• ✅ Supports both HTTP and HTTPS
• ✅ Tiny footprint (~50 lines)
• ✅ No configuration needed

How It Works

MCP Client (STDIO) → mcp-http-proxy → HTTP MCP Server
                     ↓
                 Your Cloud Run / HTTP endpoint

Requirements

• Node.js 14+

License

MIT