charles-local-mcp

Локальная, управляемая профилями автоматизация Charles Proxy для macOS. Тот же сервис приложения доступен через JSON CLI и MCP stdio-сервер.

Версия 0.1.2 поддерживает Charles 4.6.8 на macOS. Публичный пакет содержит только общие фикстуры example.com и не содержит специфичных для организаций хостов или путей.

Профиль

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"

Опустите destinationUrl для профиля только с прокси, который отключает Map Remote, сохраняя точные SSL-хосты и необязательный URL проверки. При наличии destinationUrl ограничивается адресами loopback.

Назначения Map Remote должны разрешаться в loopback-хост. verificationUrl необязателен, должен использовать HTTPS без встроенных учетных данных и должен соответствовать sourceHost.

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 serve

Состояние по умолчанию находится в ~/Library/Application Support/charles-local-mcp. Тесты и интеграторы могут изолировать его с помощью CHARLES_LOCAL_MCP_HOME или --state-dir. stdout CLI — только JSON; stdout MCP — только протокол. Диагностика использует stderr.

Команды мутации требуют macOS и Charles 4.6.8. Планы настройки и очистки истекают через 15 минут, одноразовые и отклоняются, если состояние изменилось. В каталоге состояния разрешена только одна активная сессия.

Процедура для реального устройства намеренно ручная: см. docs/manual-smoke.md.

Установка

Соберите из crates.io, если доступен локальный инструментарий Rust:

cargo install charles-local-mcp --locked

Для установки MCP-клиента в один клик на macOS используйте универсальный ресурс .mcpb из соответствующего релиза GitHub. Нативный бинарник и пакет не подписаны и не нотаризованы Apple, поэтому macOS может показать предупреждение безопасности при открытии загруженного ресурса. Проверьте SHA256SUMS из этого релиза перед установкой. Пакет запрашивает файл профилей TOML и запускает charles-local-mcp serve; профили остаются доступными только для чтения для инструментов MCP.

Сопровождающие релизов должны следовать docs/releasing.md.