产品简介
Charles-mcp MCP Server是一个将Charles Proxy接入MCP客户端的工具，使AI代理能实时读取流量增量、结构化分析历史录包，并通过summary-first输出高效探索数据，适用于需要深度网络请求分析和逆向工程的AI开发者与安全研究人员。
核心功能
- 实时捕获并支持AI代理持续读取流量增量
- 统一结构化分析live与history流量，避免原始数据混乱
- summary-first输出，先看热点摘要再钻取细节
- v3.0引入逆向工程工具链，支持导入、解码、回放与签名分析
- 跨平台支持Windows、macOS和Linux
快速开始
- 在Charles Proxy中启用Web Interface（Proxy -> Web Interface Settings），设置用户名admin和密码123456
- 确保系统已安装Python 3.10+及uv工具
- 使用命令`uvx charles-mcp`安装服务，并配置到MCP客户端（如Claude Code或Claude Desktop）
- 启动Charles MCP Server，AI代理即可通过工具合约分析流量
界面预览
与其他方案对比
| 对比项 | Charles-mcp | 同类方案 |
|---|---|---|
| 与AI代理集成方式 | 通过MCP协议直接集成，提供结构化工具契约，无需自定义脚本 | 通常需手动数据提取或编写适配代码 |
| 流量分析深度 | 支持实时捕获、历史分析及逆向工程工作流，summary-first输出 | 多数工具仅提供原始抓包数据，需额外处理 |
| 输出友好性 | 结构化摘要与细节钻取，避免上下文过载 | 原始字典输出可能快速消耗代理上下文 |
适合谁用
- 使用AI代理进行网络调试与测试的开发者
- 需要自动化分析HTTP流量的安全研究人员
- 进行逆向工程和API分析的工程师
下载与版本
当前最新版本为 v3.0.3，发布于 2026-04-21。支持 Windows、macOS、Linux。
⚠️ 注意：本项目仅提供源代码下载，不包含可直接运行的安装包（exe/dmg/apk 等。下载后需要自行编译构建才能使用，适合有一定开发经验的用户。如果你不熟悉编译流程，建议寻找同类开箱即用的替代方案。
注意事项
- 本工具仅供学习和研究使用，请遵守相关法律法规。
- 请尊重内容创作者版权，勿将下载内容用于商业或非法传播。
- 项目源码地址：https://github.com/heizaheiza/Charles-mcp