charles-local-mcp

macOS向けのローカルのみ・プロファイル駆動のCharles Proxy自動化。同じアプリケーションサービスがJSON CLIとMCP stdioサーバーを通じて公開されます。

バージョン0.1.2はmacOS上のCharles 4.6.8をサポートします。公開パッケージには汎用の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が存在する場合、ループバックアドレスに制限されます。

Map Remoteの宛先はループバックホストに解決される必要があります。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で分離できます。CLIの標準出力はJSONのみ、MCPの標準出力はプロトコルのみです。診断は標準エラー出力を使用します。

変更コマンドにはmacOSとCharles 4.6.8が必要です。セットアップおよびクリーンアッププランは15分で期限切れになり、一度きりの使用で、状態が変更された場合は拒否されます。状態ディレクトリ内でアクティブなセッションは1つだけ許可されます。

実機での手順は意図的に手動です。docs/manual-smoke.mdを参照してください。

インストール

ローカルのRustツールチェーンが利用可能な場合は、crates.ioからビルドします:

cargo install charles-local-mcp --locked

macOSでのワンクリックMCPクライアントインストールには、対応するGitHub Releaseのユニバーサル.mcpbアセットを使用します。ネイティブバイナリとバンドルはAppleによって署名または公証されていないため、ダウンロードしたアセットを開くときにmacOSがセキュリティ警告を表示する場合があります。インストール前にそのリリースのSHA256SUMSを検証してください。バンドルはTOMLプロファイルファイルを要求し、charles-local-mcp serveを開始します。プロファイルはMCPツールに対して読み取り専用のままです。

リリースメンテナーはdocs/releasing.mdに従ってください。