mcp-http-proxy

by spontaneous-order

350 downloads
Not rated
GitHub

About

An HTTP/SSE proxy server for Model Context Protocol (MCP) applications using stdio. Supports raw JSON-RPC commands via HTTP and implements direct stdio communication without an MCP SDK.

Details

Author
spontaneous-order
Downloads
350
Categories
Developer Tools

- Manages the lifecycle of a child MCP server process.
- Provides HTTP endpoints for tools and raw JSON-RPC commands.
- Delivers real-time events via Server-Sent Events (SSE).
- Includes a web dashboard for tool discovery and debugging.
- Translates URL query parameters into JSON-RPC tools/call requests.
- Supports multiple client types (curl, browser, scripts).
- Handles parameter validation and error relay.
- Provides debugging endpoints for raw message history and logs.

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name mcp-http-proxy
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Run the script rpc-proxy-worker.js with Node.js (no additional install steps besides having Node.js). The server starts on port 3005 by default, serving a web dashboard at http://localhost:3005. Clients interact via HTTP endpoints (e.g., GET /tool/:toolName, POST /rpc/raw/command) or by connecting to the SSE endpoint at /sse.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp-http-proxy": {
            "mcp-http-proxy": {
                "command": "node",
                "args": [
                    "rpc-proxy-worker.js"
                ]
            }
        }
    }
}

McpServers

{
    "mcp-http-proxy": {
        "command": "node",
        "args": [
            "rpc-proxy-worker.js"
        ]
    }
}

mcp-http-proxy

An HTTP/SSE proxy server for Model Context Protocol (MCP) applications using stdio. Supports raw JSON-RPC commands via HTTP and implements direct stdio communication without an MCP SDK.
No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.