{"repo":"heizaheiza/Charles-mcp","free":true,"listed":false,"github":"https://github.com/heizaheiza/Charles-mcp","clone":"git clone https://github.com/heizaheiza/Charles-mcp.git","description":"Charles Proxy MCP server for AI agents with live capture, structured traffic analysis, and agent-friendly tool contracts","language":"Python","stars":295,"topics":["ai-agent","charles-proxy","codex","developer-tools","mcp","openai","mcp-server","network-debugging"],"license":"MIT","category":"mcp-servers","readme_excerpt":"Charles MCP Server Docs Tool Contract AGENTS Agent Workflow Guide English README 仓库维护公告（2026-04-21） 本仓库的公开 Git 历史已于 2026-04-21 重新整理。如果你在该日期之前克隆过本仓库，请在继续贡献前重新克隆。不要从旧的本地克隆直接合并或推送，否则可能会把过期历史重新引入仓库。 Charles MCP Server 用于把 Charles Proxy 接入 MCP 客户端，让 agent 可以稳定地读取实时流量、分析历史录包，并在需要时再展开单条请求细节。 它解决的核心问题只有三个： - 录制还在进行时，agent 也能持续读取当前 session 的增量流量 - live 与 history 统一走结构化分析，不再让 agent 直接消费原始抓包字典 - 默认使用 summary-first 输出，先看热点与摘要，再 drill-down 到单条 detail 本次更新方向（v3.0） v3.0 的更新方向是： charles-mcp 的能力开始从“流量查看/筛选”向“逆向工程工作流”延伸。 - 在保留原有 live/history 分析能力的基础上，新增 reverse-analysis 工具链（导入、查询、解码、回放、签名候选分析、live 逆向会话）。 - 目标是让 agent 不只看到流量，还能围绕认证、签名、参数变异与可重放性，形成更完整的逆向分析闭环。 快速开始 1. 开启 Charles Web Interface 在 Charles 中依次进入： Proxy - Web Interface Settings 请确认： - 勾选 Enable web interface - 用户名为 admin - 密码为 123456 菜单位置示意： 设置窗口示意： 2. 安装并配置到 MCP 客户端 无需 clone 仓库，无需手动创建虚拟环境。需要先安装 uv。 Claude Code CLI Claude Desktop / Cursor / 通用 JSON 配置 Codex CLI 让 AI 自动安装 将以下提示词复制粘贴给任意 AI agent（Claude Code、ChatGPT、Gemini CLI、Cursor Agent 等），agent 会自动完成安装和配置： 🔴 点击展开自动安装提示词（推荐） 前置条件 - Python 3.10+ - 本机已启动 Charles Proxy - Charles Web Interface 已启用 - Charles 代理默认监听 127.0.0.1:8888 推荐默认保持 CHARLES MANAGE LIFECYCLE=false 。除非你明确希望 MCP server 接管 Charles 生命周期，否则不要让它在退出时关闭你的 Charles 进程。 环境变量 变量 默认值 说明 --- --- --- CHARLES USER admin Charles Web Interface 用户名 CHARLES PASS 123456 Charles Web Interface 密码 CHARLES PROXY HOST 127.0.0.1 Charles 代理主机 CHARLES PROXY PORT 8888 Charles 代理端口 CHARLES CONFIG PATH 自动探测 Charles 配置文件路径 CHARLES REQUEST TIMEOUT 10 控","default_branch":null,"files":null,"tree":[],"storefront":"/r/heizaheiza","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/heizaheiza/Charles-mcp/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}