yfe404/proxy-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
MCP server that runs an explicit HTTP/HTTPS MITM proxy
Обзор
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@latestsilently stays stale. Update your MCP config to the GitHub form above. See Setup.
Table of Contents
- Setup
- HTTP Proxy Configuration
- Boundaries
- Tools Reference
- Resources
- Usage Example
- Architecture
- Testing
- Credits
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
preparebuild), 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)Установка
npx -y github:yfe404/proxy-mcp#semver:^3Конфигурация
{
"mcpServers": {
"proxy-mcp": {
"command": "npx",
"args": ["-y", "github:yfe404/proxy-mcp#semver:^3"]
}
}
}