charles-local-mcp

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.

Profil

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

Befehle

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 serve

Der 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.

Installation

Von crates.io bauen, wenn ein lokales Rust-Toolkit verfügbar ist:

cargo install charles-local-mcp --locked

Fü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.