用途
proxykit-mcp 是 ProxyKit 的 MCP（Model Context Protocol）服务器，让 Claude、Cursor 以及任何 MCP 主机能够驱动一个本地运行的 ProxyKit HTTP(S) 调试代理。用户可以在编辑器里输入自然语言指令，针对 ProxyKit 已经抓取到的真实流量执行操作，例如“把结账端点 mock 成一半概率失败”“把我最近 500 条抓取请求与基线对比并总结”“给 /api/payments 增加 800 ms 延迟并重放该会话”。
主要能力
它通过 stdio 暴露工具调用，每个工具调用对应一次发往 127.0.0.1 上引擎控制 API 的 HTTP 请求。服务器自身不保存任何流量，也不与用户本机之外的任何东西通信。
按权限层级划分，共 50 个工具，分为五层：
- readonly（默认启用）——读取状态。
- mutate——编辑规则：create_mock_rule、update_mock_rule、delete_mock_rule、toggle_mock_rule、create_mock_from_request、create_rewrite_rule、update_rewrite_rule、delete_rewrite_rule、toggle_rewrite_rule、create_chaos_rule、update_chaos_rule、delete_chaos_rule、toggle_chaos_rule、attach_environment。
- capture——控制捕获：start_capture、stop_capture、clear_traffic、release_breakpoint。
- analysis——AI 与分析工作流：analyze_request、rescan_findings、dismiss_finding、restore_finding、propose_redaction_rules、run_ai_workflow、compare_sessions。
- replay——会话、重放与规则包：start_session、stop_session、delete_session、replay_session、replay_request、import_rule_pack、install_rule_pack、export_rule_pack、delete_rule_pack。
使用方式
该二进制文件随每个 ProxyKit CLI 归档和桌面应用一同分发，可任选其一。
通过 Homebrew（CLI）安装后，proxykit、proxy-engine 和 proxykit-mcp 会出现在 PATH 中。Windows 上可通过 WinGet 安装。也可从桌面应用获取，二进制文件捆绑于应用内（下载地址：https://proxykit.net/download）。
连接 MCP 主机时，引擎启动时会写入一个 control.token 文件；让 MCP 服务器指向该文件，不要把令牌粘贴进配置。将相应配置加入主机的 MCP 配置（如 ~/.cursor/mcp.json、Claude Desktop 的 claude_desktop_config.json、.mcp.json 等）。随后启动 ProxyKit（桌面应用或 proxykit start --headless），重启 MCP 主机，即可让它执行“列出 ProxyKit 中我最近抓取的流量”。各客户端的具体路径与桌面应用一键安装方式记录在 https://proxykit.net/mcp。
官方网站：https://proxykit.net；设置指南（所有主机）：https://proxykit.net/mcp；CLI 参考：https://proxykit.net/docs。
安全与限制
服务器仅限本地：调用 127.0.0.1:17171，引擎绑定回环地址并拒绝非回环调用者。访问受令牌约束：每次控制调用都携带 X-Proxykit-Control-Token，无令牌即无访问权限。权限按层级最小化：readonly 为默认且只能读取；任何会修改规则、控制捕获或重放流量的操作，在你明确允许该层级之前都处于关闭状态，因此 agent 无法在你未授权的情况下创建 mock 或清空抓包。响应体在服务端、到达 agent 之前即被脱敏。其余层级通过 PROXYKIT_MCP_TIER 选择性启用。
授权
本仓库（文档、Dockerfile、注册表元数据）采用 MIT 许可，可自由复用。ProxyKit 本身——proxykit-mcp 二进制及其驱动的引擎——为专有软件（© 2026 Seyed Ahmad Sarollahi），按其自身条款授权（https://proxykit.net/terms#license）。本仓库不授予 ProxyKit 软件的任何权利；二进制文件在构建时依据其自身条款从发布服务器下载。
