farshadmomo/lan-direct

Skill + browser MCP for Claude Code and Codex: your app and browser reach domestic services over the real ISP while the agent stays on the VPN. Per-socket binding, per-host routing, no admin, nothing

About lan-direct

A skill and a browser MCP for coding agents behind a full-tunnel VPN — Claude Code and Codex.

Your VPN has to stay on, because that's how the agent reaches its API. But the app you're testing calls services that reject the VPN's foreign exit IP: a domestic API, a payment or SMS gateway, a bank endpoint. Turning the VPN off isn't an option — it cuts the agent off.

lan-direct gives the app an ISP-direct path while the agent stays on the tunnel. No admin, no routing-table edits, no VPN reconfiguration. How it works.

Requires Node ≥ 20.6, plus PowerShell on Windows or bash and curl on Linux/macOS. No admin, no symlinks, no renaming.

Then restart the agent. That's it — the same three lines on every platform.

npx -y lan-direct browser is the better MCP command however you install: it survives the checkout moving, which an absolute path into a clone does not.

Why "--" is quoted. On Windows claude resolves to claude.ps1, and PowerShell's parameter binder strips a bare -- before the script ever sees it. The CLI then reads -y as one of its own flags and fails with error: unknown option '-y'. Quoting protects it, and quotes are a no-op in bash — so the same line works in PowerShell, bash and cmd.

Prefer this if you want to edit the skill or track it — one git pull updates everything, where npm needs npm update -g lan-direct && lan-direct install-skill because install-skill copies files rather than linking them.

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/farshadmomo--lan-direct.html)

Related MCP servers