概览

proxy-mcp is an MCP server that runs an explicit HTTP/HTTPS MITM proxy (L7). It captures requests/responses, lets you modify traffic in-flight (headers/bodies/mock/forward/drop), supports upstream proxy chaining, and records TLS fingerprints for connections to the proxy (JA3/JA4) plus optional upstream server JA3S. Ships "interceptors" to route the cloakbrowser stealth browser, CLI tools, and Docker containers through the proxy, plus Playwright-driven browser automation with locator-based click, typing, scroll, and ARIA snapshots. 72 tools + 7 resources + 3 resource templates. Built on mockttp and cloakbrowser. npm's publishing system has become too annoying to be worth it — expiring tokens that silently break releases, and a mandatory passkey/2FA enrollment maze just to change a package setting. Distribution now happens directly from this repository: Versions ≤ 3.3.2 remain on npmjs but will never be updated — npx -y proxy-mcp@latest silently stays stale.

README

以下为原文 README 节选，完整内容请查看原文。

proxy-mcp

proxy-mcp is an MCP server that runs an explicit HTTP/HTTPS MITM proxy (L7). It captures requests/responses, lets you modify traffic in-flight (headers/bodies/mock/forward/drop), supports upstream proxy chaining, and records TLS fingerprints for connections to the proxy (JA3/JA4) plus optional upstream server JA3S. Ships “interceptors” to route the cloakbrowser stealth browser, CLI tools, and Docker containers through the proxy, plus Playwright-driven browser automation with locator-based click, typing, scroll, and ARIA snapshots.

72 tools + 7 resources + 3 resource templates. Built on mockttp and cloakbrowser.

[!IMPORTANT] proxy-mcp is no longer published to npmjs. npm’s publishing system has become too annoying to be worth it — expiring tokens that silently break releases, and a mandatory passkey/2FA enrollment maze just to change a package setting. Distribution now happens directly from this repository:
npx -y "github:yfe404/proxy-mcp#semver:^3"
Versions ≤ 3.3.2 remain on npmjs but will never be updated — npx -y proxy-mcp@latest silently stays stale. Update your MCP config to the GitHub form above. See Setup.

Setup

Quick install (Claude Code)

claude mcp add proxy-mcp -- npx -y "github:yfe404/proxy-mcp#semver:^3"

This installs proxy-mcp as an MCP server using stdio transport, straight from GitHub — no registry involved. The #semver:^3 range resolves against this repo’s version tags, so new releases are picked up automatically.

Note: the first install compiles from source (a prepare build), so it takes a few seconds longer than a registry tarball — subsequent launches use the npx cache. Why not npmjs anymore? See the announcement at the top: their publishing system got too annoying.

Scopes:

# Per-user (available in all projects)
claude mcp add --scope user proxy-mcp -- npx -y "github:yfe404/proxy-mcp#semver:^3"

# Per-project (shared via .mcp.json, commit to repo)

在 GitHub 查看完整 README

安装

npx -y github:yfe404/proxy-mcp#semver:^3

新手？先看 mcpskill.org 教程 →

配置

{
  "mcpServers": {
    "proxy-mcp": {
      "command": "npx",
      "args": ["-y", "github:yfe404/proxy-mcp#semver:^3"]
    }
  }
}

yfe404/proxy-mcp

概览

README

proxy-mcp

Table of Contents

Setup

Quick install (Claude Code)

安装

配置