charles-local-mcp

Automatización de Charles Proxy solo local y basada en perfiles para macOS. El mismo servicio de aplicación se expone a través de una CLI JSON y un servidor MCP stdio.

La versión 0.1.2 es compatible con Charles 4.6.8 en macOS. El paquete público contiene solo fixtures genéricos de example.com y no incluye hosts ni rutas específicos de la organización.

Profile

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"

Omita destinationUrl para un perfil solo proxy que deshabilita Map Remote mientras conserva los hosts SSL exactos y la URL de verificación opcional. Cuando está presente, destinationUrl se restringe a direcciones de bucle local.

Los destinos de Map Remote deben resolverse a un host de bucle local. verificationUrl es opcional, debe usar HTTPS sin credenciales incrustadas y debe coincidir con sourceHost.

Related MCP server: Charles MCP Server

Commands

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

El estado por defecto es ~/Library/Application Support/charles-local-mcp. Las pruebas y los integradores pueden aislarlo con CHARLES_LOCAL_MCP_HOME o --state-dir. La salida estándar de la CLI es solo JSON; la salida estándar de MCP es solo protocolo. Los diagnósticos usan stderr.

Los comandos de mutación requieren macOS y Charles 4.6.8. Los planes de configuración y limpieza caducan después de 15 minutos, son de un solo uso y se rechazan si el estado cambió. Solo se permite una sesión activa en un directorio de estado.

El procedimiento para dispositivos reales es intencionalmente manual: consulte docs/manual-smoke.md.

Install

Compile desde crates.io cuando haya una cadena de herramientas Rust local disponible:

cargo install charles-local-mcp --locked

Para una instalación de cliente MCP con un solo clic en macOS, use el recurso universal .mcpb de la versión correspondiente de GitHub Release. El binario nativo y el paquete no están firmados ni notarizados por Apple, por lo que macOS puede mostrar una advertencia de seguridad al abrir un recurso descargado. Verifique SHA256SUMS de esa versión antes de instalar. El paquete solicita un archivo de perfiles TOML e inicia charles-local-mcp serve; los perfiles permanecen de solo lectura para las herramientas MCP.

Los mantenedores de versiones deben seguir docs/releasing.md.