Charles-mcp

概述

Charles MCP Server 为 AI 代理提供与 Charles Proxy 交互的结构化接口，支持实时流量监控和历史数据包分析。服务器采用摘要优先方法，让代理可以先获取流量概览再深入特定请求。3.0 版本扩展了逆向工程工作流功能，包括请求回放、签名分析和实时逆向分析会话。该实现专注于优化令牌使用，通过过滤空值、减少负载大小并提供默认紧凑预览来提升效率。

试试问 AI

装完之后，这里有 5 个你可以让 AI 做的事：

• start_live_capture

  Start or take over current live capture, returning a capture_id

  试试:Start capturing network traffic in real-time试试:Begin live session to monitor network requests
• read_live_capture

  Incrementally read live capture returning only compact route summaries

  试试:Show me new network traffic since last time试试:Get latest HTTP requests in the live session
• peek_live_capture

  Preview new traffic without advancing cursor, returning only compact route summaries

  试试:Check what new requests have arrived without marking as read试试:Preview latest traffic without consuming it
• stop_live_capture

  End capture and optionally persist snapshot

  试试:Stop the current live capture session试试:Finish capturing and save the session
• query_live_capture_entries

  Structure summary of live capture without advancing cursor

  试试:Find all POST requests in the live capture试试:Show me all API calls with 404 status
• group_capture_analysis

  Aggregate and group live or history results by host/path/status

  试试:Group traffic by most accessed hosts试试:Show me requests grouped by HTTP status codes
• get_traffic_entry_detail

  Read single entry's detail with warnings for large responses

  试试:Show me the full details of entry 12345试试:Get complete information about this specific request
• analyze_recorded_traffic

  Analyze specified recording or latest recording with structured summary

  试试:Analyze the recorded session from yesterday试试:Give me a summary of this .chlsj file
• list_recordings

  List currently saved recording files

  试试:Show me all saved recordings试试:What capture files are available?
• charles_status

  Check Charles connection status and current live capture state

  试试:Is Charles proxy running?试试:Check status of the current capture session
• reverse_import_session

  Import official Charles XML/native session into canonical reverse store

  试试:Import this Charles session for reverse analysis试试:Load saved session for detailed analysis
• reverse_replay_entry

  Replay single imported request with optional parameter variations

  试试:Replay this request with modified headers试试:Test if this API call can be replayed successfully

可对比工具

安装

{
  "mcpServers": {
    "charles": {
      "command": "uvx",
      "args": ["charles-mcp"],
      "env": {
        "CHARLES_USER": "admin",
        "CHARLES_PASS": "123456",
        "CHARLES_MANAGE_LIFECYCLE": "false"
      }
    }
  }
}

claude mcp add-json charles '{
  "type": "stdio",
  "command": "uvx",
  "args": ["charles-mcp"],
  "env": {
    "CHARLES_USER": "admin",
    "CHARLES_PASS": "123456",
    "CHARLES_MANAGE_LIFECYCLE": "false"
  }
}'

FAQ

这是否需要安装 Charles Proxy？

是的，您需要安装并运行 Charles Proxy，并启用 Web 界面。

这可以用于自动化测试吗？

是的，该服务器提供用于自动化流量分析、请求回放和签名分析的工具，适合测试工作流。

Charles-mcp 对比