Mmcp.market

front-proxy MCP server

by gutomezencio·io.github.gutomezencio/front-proxy·v0.8.2
No reviews yet

Map local domains (and HTTPS) to apps on local ports, OS-wide, via /etc/hosts and a reverse proxy.

A92/100grade A
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
A92/100

full report

Adoption
Growing

0 stars1.1k downloads/wk

Reviews

Write one

Nobody has reviewed front-proxy yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

front-proxy tools (7, 3 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • add_host

    Map a local domain to an app on a local port, eq. myapp.local → 3000. Saved to the config; call apply_config to use it in the running proxy.

  • apply_config

    Load the saved config into the running proxy: routes, HTTPS certs and the /etc/hosts block, without restarting it. Needs the proxy running with its admin page (the default).

  • generate_certswrite action

    Create locally trusted HTTPS certs with mkcert for one domain, or for every configured domain when none is given. Needs mkcert installed, with its local CA installed once (`mkcert -install`).

  • list_hosts

    List the configured domains with their local port and HTTPS cert status ("own", "missing" or "default").

  • proxy_status

    Whether front-proxy is running, whether HTTPS is on, whether saved changes are waiting for apply_config, and whether each app listens on its port ("up"/"down").

  • remove_hostwrite action

    Remove a domain from the config. Call apply_config to remove it from the running proxy and /etc/hosts.

  • update_hostwrite action

    Point a configured domain to another local port. Call apply_config to use it in the running proxy.

Public scan report

scanner v0.1.10 · 2026-10-09 · same rubric, same numbers if you re-run it

no findings
  • Code scan18 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 1 days ago15/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

Install front-proxy in Claude Code, Cursor or VS Code

Runs npx -y front-proxy on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add front-proxy -- npx -y front-proxy
Add to Cursor

What the publisher says

From the front-proxy repository's README, as published. We do not edit it. Read it on GitHub

front-proxy

Reach apps on local ports, like localhost:3000, through real-looking domains, like local-dev.mylivedomain.com, over HTTP or HTTPS.

While it runs, front-proxy adds your domains to /etc/hosts, pointing them at 127.0.0.1, and runs a reverse proxy on ports 80 and 443. When it stops, it removes them. The proxy reads the Host header of each request and forwards it to the port you mapped to that domain. HTTPS uses locally trusted certificates from mkcert. Because the mapping lives in the OS, it works in every browser and tool on your machine, not just one.

Browser, curl, Playwright...
          │
          │  https://local-dev.mylivedomain.com
          ▼
  ┌───────────────────────────────────────────────┐
  │ /etc/hosts                                    │
  │   127.0.0.1  local-dev.mylivedomain.com       │
  └───────────────────────────────────────────────┘
          │
          │  127.0.0.1:443  (or :80 for http)
          ▼
  ┌───────────────────────────────────────────────┐
  │ front-proxy                                   │
  │   1. TLS with the domain's mkcert certificate │
  │   2. Host header → port, from proxyHosts.json │
  │        local-dev.mylivedomain.com → 3000      │
  │      (unknown host → 502)                     │
  └───────────────────────────────────────────────┘
          │
          │  http://127.0.0.1:3000
          ▼
  Your local app

Why

Some third-party services only accept requests from an allowlist of domains (Stripe and Google Tag Manager, for example), and some APIs block localhost with CORS. Browser extensions can fake a domain for one browser. front-proxy works for the whole OS, so it also covers other browsers, CLI tools and headless Playwright runs with no extra configuration.

Requirements

  • Node.js 22.12 or newer
  • macOS or Linux (it edits /etc/hosts and uses sudo)
  • mkcert, only for HTTPS (brew install mkcert on macOS)

Installation

npm install -g front-proxy

The front-proxy command is now available in your terminal.

If npm install -g fails with EACCES, your npm global folder is owned by root. That's common with the system Node on Linux or the official macOS installer. Use a Node installed with nvm or Homebrew, or run sudo npm install -g front-proxy.

To update:

npm update -g front-proxy

Your domains and certificates live in ~/.front-proxy (see Configuration), so updates and reinstalls keep them.

To run it from a clone instead, see Development.

Usage

front-proxy add local-dev.livedomain.com:3000   # map a domain to a local port
front-proxy                                     # start the proxy

Then open http://local-dev.livedomain.com (or https:// once you've set up certificates).

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

front-proxy: common questions

Is front-proxy MCP server safe?
Yes, by our scan: it is graded A (92/100). Read the front-proxy safety report
How do I install front-proxy?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does front-proxy need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is front-proxy maintained?
The last commit was 5 days ago (2026-10-08). The latest release is v0.8.2.
What can I use instead of front-proxy?
Servers from other publishers that do the same job: Wayfinder MCP server, Whalesync MCP server and Repo Graph MCP server. Compare all front-proxy alternatives.

Alternatives to front-proxy

Same job from other publishers: the closest match first, then the best rated.

All front-proxy alternatives →
  • Wayfinder
    Read local AI coding paths, decisions, and branches as an in-host voyage map.
    B
  • Whalesync
    Build and manage Whalesync syncs: connect apps, map tables and fields, monitor and fix issues.
    A
  • Repo Graph
    Structural graph map of any codebase so LLMs navigate by structure, not guesswork.
    A
  • Agentmap
    The TS/JS-accurate repo map for coding agents: ts-morph import/symbol/call graph + MCP query tools
    A
  • Infranodus Infranodus
    Map text into knowledge graphs to create a structured representation of conceptual relations and t…
    A

More from gutomezencio →