Homerun

What it does

Homerun turns your laptop into a local HTTP proxy (localhost:8080) so cloud-based AI agents can route their web requests through your residential IP address. This bypasses bot-detection systems that block datacenter IPs, making it possible to automate web tasks that require a genuine home connection. A built-in live dashboard shows real-time request counts and recent traffic. An optional reverse tunnel client connects to a relay server so remote agents can reach your local proxy.

Tools

Note: the MCP server component is scaffolded but not yet fully wired into the desktop runtime as of v0. The project exposes the following planned capabilities:

• proxy_request — route an HTTP request through the local proxy and return the response
• get_traffic — retrieve recent proxy traffic log entries
• tunnel_status — check whether the reverse tunnel is connected and return the public relay URL

Installation

Requires Bun and Electrobun.

git clone https://github.com/acoyfellow/homerun
cd homerun
bun install
bun run dev

The proxy starts on 127.0.0.1:8080. Test with:

curl -x http://127.0.0.1:8080 http://httpbin.org/get

Add to claude_desktop_config.json once the MCP server is wired in:

{
  "mcpServers": {
    "homerun": {
      "command": "bun",
      "args": ["run", "/path/to/homerun/src/mcp-server.ts"]
    }
  }
}

Supported hosts

No specific host confirmed in README — targets Claude Desktop when MCP server is complete.