Nur lokal, profilgesteuerte Charles-Proxy-Automatisierung für macOS. Derselbe Anwendungsdienst wird über eine JSON-CLI und einen MCP-stdio-Server bereitgestellt.
Version 0.1.2 unterstützt Charles 4.6.8 auf macOS. Das öffentliche Paket enthält
nur generische example.com-Fixtures und keine organisationsspezifischen Hosts oder Pfade.
schemaVersion = 1
[profiles.demo]
sourceHost = "app.example.com"
sourcePath = "/api*" # optional Charles path pattern
destinationUrl = "http://127.0.0.1:8080"
sslHosts = ["app.example.com"]
verificationUrl = "https://app.example.com/health"Lassen Sie destinationUrl für ein reines Proxy-Profil weg, das Map Remote deaktiviert, während
die exakten SSL-Hosts und die optionale Verifizierungs-URL beibehalten werden. Wenn vorhanden,
ist destinationUrl auf Loopback-Adressen beschränkt.
Map-Remote-Ziele müssen auf einen Loopback-Host auflösen. verificationUrl ist
optional, muss HTTPS ohne eingebettete Anmeldedaten verwenden und muss
sourceHost entsprechen.
Related MCP server: Charles MCP Server
charles-local-mcp doctor --json
charles-local-mcp --profiles-file profiles.toml profiles validate --json
charles-local-mcp --profiles-file profiles.toml setup plan --profile demo --platform android --json
charles-local-mcp --profiles-file profiles.toml setup apply --token TOKEN --json
charles-local-mcp setup resume --token TOKEN --json
charles-local-mcp status --json
charles-local-mcp cleanup plan --json
charles-local-mcp cleanup apply --token TOKEN --json
charles-local-mcp serveDer Zustand wird standardmäßig in ~/Library/Application Support/charles-local-mcp gespeichert. Tests und
Integratoren können ihn mit CHARLES_LOCAL_MCP_HOME oder --state-dir isolieren.
Die CLI-Standardausgabe ist nur JSON; die MCP-Standardausgabe ist nur Protokoll. Diagnosen verwenden stderr.
Mutationsbefehle erfordern macOS und Charles 4.6.8. Setup- und Bereinigungspläne
laufen nach 15 Minuten ab, sind nur einmal verwendbar und werden abgelehnt, wenn sich der Zustand geändert hat.
Nur eine aktive Sitzung ist in einem Zustandsverzeichnis zulässig.
Die Prozedur für echte Geräte ist absichtlich manuell: siehe
docs/manual-smoke.md.
Von crates.io bauen, wenn ein lokales Rust-Toolkit verfügbar ist:
cargo install charles-local-mcp --lockedFür eine Ein-Klick-MCP-Client-Installation auf macOS verwenden Sie das universelle .mcpb-Asset
aus dem passenden GitHub-Release. Das native Binärprogramm und das Bundle sind nicht von Apple signiert oder notarisiert, daher kann macOS beim Öffnen eines heruntergeladenen Assets eine Sicherheitswarnung anzeigen. Überprüfen Sie SHA256SUMS aus diesem Release vor der Installation. Das Bundle fragt nach einer TOML-Profildatei und startet charles-local-mcp serve; Profile bleiben für MCP-Tools schreibgeschützt.
Release-Maintainer sollten docs/releasing.md folgen.
This server cannot be deployed
Capture, inspect & debug HTTPS traffic across iOS, Android, browsers & backends — 304 MCP tools.
Secure tunneling, reverse proxy and remote access for local applications.
Tailscale device, route, DNS, key, user, and ACL management over MCP and CLI.
Remote MCP for Android CLI agent build gate, structured receipts, audit logs, and reviewer-ready evi
