mcp-http-proxy

An MCP server that exposes a single http_get tool, allowing MCP clients to perform HTTP GET requests to arbitrary URLs and receive the response.

Transport

Uses the Streamable HTTP MCP transport, listening on port 8000. The server operates in stateless mode — no session is maintained between requests.

Tool

http_get

Performs an HTTP GET request to the provided URL.

Input

Field	Type	Description
url	string	The URL to fetch

Output (JSON)

Field	Type	Description
status	number	HTTP response status code
statusText	string	HTTP response status text
headers	object	Response headers as key/value pairs
body	string	Response body as text

If the request fails (e.g. DNS error, connection refused), the tool returns an error result with a descriptive message.

Requirements

• Node.js 18+

Installation

npm install

Usage

Development (runs directly with tsx, no compile step):

npm run dev

Production (compile then run):

npm run build
npm start

The server will print:

MCP HTTP proxy server listening on http://localhost:8000/mcp

MCP Client Configuration

Point your MCP client at http://localhost:8000/mcp. For example, in a Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "http-proxy": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

Project Structure

mcp-http-proxy/
├── src/
│   └── index.ts      # MCP server entry point
├── package.json
└── tsconfig.json