使用说明
MCP Burp Suite检查员
用于测试和调试模型上下文协议（MCP）服务器的全面Burp Suite扩展。
概述
MCP Inspector为安全测试MCP服务器提供了一个功能齐全的界面，具有本机Burp集成，包括中继器式请求编辑、历史管理和嵌套MCP响应的智能JSON处理。
特性
核心功能
- 完全支持MCP协议：HTTP和服务器发送事件（SSE）传输
- 会话管理：自动会话ID处理和连接状态跟踪
- 请求编辑器：带有Raw/Hex/Pretty选项卡的本地Burp消息编辑器
- 历史导航：50个请求滚动历史记录，带前进/后退按钮
- 智能JSON解包：自动从响应中提取嵌套/转义的JSON
MCP特定功能
- 工具浏览器：显示所有可用工具及其参数的交互式表格
- 资源浏览器：查看和测试MCP资源
- 提示浏览器：访问并执行MCP提示
- 自动发现：连接后自动列出工具
- 模式感知：根据工具模式预填充请求参数
高级功能
- 自定义头：配置身份验证令牌和API密钥
- 可配置超时：调整请求和SSE超时行为
- 进度跟踪：监控长时间运行的MCP操作
- 主题支持：自动调整UI以适应暗/亮模式
- 详细日志记录：协议级调试信息
安装
来自BApp商店（推荐）
- 开放式卧铺套房
- 首选 扩展器>BApp商店
- 搜索“MCP检查员”
- 点击 安装
手动安装
- 下载
mcp_inspector.py来自此存储库 - 开放式卧铺套房
- 首选 扩展器>扩展
- 点击 添加
- 集 扩展类型 到 python
- 选择下载的文件
- 点击 下一步
需求
- Burp Suite：专业版或社区版
- Java：版本11或更高版本（用于HTTP/2支持）
- python：Burp中启用了Jython支持（与Burp捆绑在一起）
用法
快速开始
-
打开扩展
- 导航到 MCP检查员 Burp中的选项卡
-
连接到MCP服务器
- 输入端点：https://example.com/mcp
- 点击“连接”
-
浏览可用工具
- 连接后自动加载工具
- 在“工具”选项卡中查看参数和说明
-
执行请求
- 右键单击任何工具→ “发送给请求编辑器”
- 根据需要修改参数
- 点击“发送”
-
处理复杂的响应
- 点击“Unscape JSON”提取嵌套JSON
高级用法
自定义身份验证
- 点击“标题”按钮
- 添加身份验证标头：
- 授权：请在此处携带您的代币
- X-API-Key：你的密钥
- 单击“确定”
超时配置
- 点击“超时”按钮
- 配置：
- 请求超时：每个请求的初始超时
- 进度重置：自动延长进度事件的超时时间
- 最大总超时：长时间操作的硬限制
右键单击上下文菜单
- 工具选项卡：发送到请求编辑器，复制工具名称
- 资源选项卡：发送到请求编辑器，复制URI
截图
主界面
该扩展提供了一个选项卡式界面，其中包含：
- 工具：浏览并测试可用的MCP工具
- 请求编辑器：完全Burp中继器功能
- 资源：访问MCP资源
- 提示词：使用MCP提示
- 察看连接信息：连接和功能详细信息
- 日志：协议级调试
状态栏
颜色编码状态指示器：
- 灰色[*]：准备就绪
- 橙色[~]：工作/加工
- 绿色[+]：成功
- 红色[X]：错误
常见问题
扩展无法加载
- 确保在Burp中启用了Python/Jython（扩展器>选项）
- 检查Java版本是否为11+(
java -version) - 查看扩展器>错误选项卡中的错误输出
连接失败
- 验证MCP端点URL是否正确
- 检查是否需要自定义标头/身份验证
- 查看日志选项卡以获取详细的错误消息
SSE不工作
- 一些MCP服务器使用轮询而不是SSE
- 检查服务器信息选项卡以了解SSE端点状态
- 如果操作缓慢，请增加超时设置
Unscape JSON不工作
- 检查日志选项卡以获取详细的处理信息
- 某些响应可能不包含转义的JSON
- 尝试在“原始”选项卡中手动格式化
调试日志记录
启用详细日志记录：
- 首选 日志 标签
- 所有MCP协议操作都记录了时间戳
- 状态更改和错误已明确标记
许可证
MIT许可证-有关详细信息，请参阅许可证文件
致谢
- 为 模型上下文协议 规格
- 使用Burp Suite Extender API
- 集成原生Burp消息编辑器，实现一致的用户体验
由以下材料制成❤️ 面向安全测试社区
