charles-local-mcp

로컬 전용, 프로필 기반 Charles Proxy 자동화 도구로 macOS용입니다. 동일한 애플리케이션 서비스가 JSON CLI와 MCP stdio 서버를 통해 노출됩니다.

버전 0.1.2는 macOS에서 Charles 4.6.8을 지원합니다. 공개 패키지에는 일반적인 example.com 픽스처만 포함되어 있으며 조직별 호스트나 경로는 포함되지 않습니다.

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"

프록시 전용 프로필의 경우 destinationUrl을 생략하여 Map Remote를 비활성화하면서 정확한 SSL 호스트와 선택적 검증 URL을 유지합니다. destinationUrl이 있으면 루프백 주소로 제한됩니다.

Map Remote 대상은 루프백 호스트로 확인되어야 합니다. verificationUrl은 선택 사항이며, 자격 증명이 포함되지 않은 HTTPS를 사용해야 하고 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

상태는 기본적으로 ~/Library/Application Support/charles-local-mcp에 저장됩니다. 테스트와 통합자는 CHARLES_LOCAL_MCP_HOME 또는 --state-dir로 이를 격리할 수 있습니다. CLI 표준 출력은 JSON만, MCP 표준 출력은 프로토콜만 출력합니다. 진단 정보는 표준 오류(stderr)를 사용합니다.

변경 명령은 macOS와 Charles 4.6.8이 필요합니다. 설정 및 정리 계획은 15분 후 만료되며, 일회용이고, 상태가 변경되면 거부됩니다. 상태 디렉터리에는 활성 세션이 하나만 허용됩니다.

실제 기기 절차는 의도적으로 수동입니다: docs/manual-smoke.md를 참조하세요.

Install

로컬 Rust 툴체인을 사용할 수 있으면 crates.io에서 빌드합니다:

cargo install charles-local-mcp --locked

macOS에서 원클릭 MCP 클라이언트 설치를 위해 해당 GitHub 릴리스의 유니버설 .mcpb 자산을 사용하세요. 네이티브 바이너리와 번들은 Apple의 서명 또는 공증을 받지 않았으므로, macOS는 다운로드한 자산을 열 때 보안 경고를 표시할 수 있습니다. 설치 전에 해당 릴리스의 SHA256SUMS를 확인하세요. 번들은 TOML 프로필 파일을 요청하고 charles-local-mcp serve를 시작합니다. 프로필은 MCP 도구에 대해 읽기 전용으로 유지됩니다.

릴리스 관리자는 docs/releasing.md를 따라야 합니다.