README

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

mcp-http-proxy

README

mcp-http-proxy

Transport

Tool

http_get

Requirements

Installation

Usage

MCP Client Configuration

Project Structure

Recommended Servers

`http_get`