MCP黑匣子：记录Agent会话，标记危险tool call，回放复现

背景

随着大语言模型（LLM）与外部工具（MCP 插件）的深度集成，AI Agent 在自动化流程中频繁调用数据库、文件系统、环境变量等敏感操作。然而，开发者和运维人员往往难以追踪每次 tool call 的具体参数与执行上下文，导致数据泄露风险难以审计、bug 复现困难。现有的日志系统大多通用且无针对 MCP 协议的结构化记录能力，亟需一种轻量、专为 MCP 服务器设计的记录与回放工具。

核心内容

该工具名为 mcp-flight-recorder（MCP 飞行记录器），命名借鉴了飞机黑匣子的概念，专门用于记录 MCP stdio 服务器运行期间的所有 tool call 参数与调用细节。它是一款 CLI 工具，主要面向以下场景：

• 审计敏感信息是否泄漏：自动记录每次 tool call 的输入输出，开发者可事后检查是否有数据库删除、环境变量读取等高风险操作。
• 复现 bug：通过回放记录，可以精确重现调用序列，便于定位问题。
• 可视化报告：支持生成可分享的 Web 报告页面，页面中包括危险操作标记和敏感信息脱敏处理。

工具具备自动识别能力：当检测到删除表（如 DROP TABLE）、读取环境变量（如 env）等操作时，会将其标记为危险行为，并在报告中以警告样式（[!warning]）突出显示。同时，工具内置敏感信息脱敏机制，用户可放心将报告页面分享给同事或社区，无需担心真实凭证或数据暴露。

当前项目处于早期阶段，开发者表示后续会补充更详细的项目介绍。源码已托管在 GitHub（仓库地址：GitHub - teee32/mcp-flight-recorder: Flight recorder and replay debugger for MCP stdio servers. · GitHub），目前社区有 2 个帖子、2 位参与者讨论。

关键要点

• 记录粒度：捕获每次 tool call 的完整参数，包括输入和输出，支持结构化存储。
• 危险操作自动识别：内置规则可自动标记如 DROP TABLE、读取环境变量等高风险调用，减少人工审查成本。
• 敏感信息脱敏：对报告中的敏感字段（如 API Key、密码）进行自动替换或遮蔽，满足合规要求。
• 可回放调试：支持将记录的执行过程进行回放，方便开发者调试 Agent 中出现的异常行为。
• 轻量 CLI 工具：无需额外服务器或数据库，直接集成到 MCP stdio 服务器的工作流中。
• 报告分享：生成的 Web 页面可独立分享，配合脱敏功能，适用于跨团队或开源项目的协作审计。

意义与影响

mcp-flight-recorder 填补了 MCP 生态中审计与调试工具的空白。对于依赖 AI Agent 执行自动化运维、数据操作的企业而言，它提供了以下价值：

1. 增强可控性：Agent 的每次工具调用不再处于黑箱状态，开发者可以像飞机黑匣子一样事后查阅，及时发现并遏制潜在的数据泄露或误操作。
2. 提升调试效率：回放功能让 bug 复现不再依赖随机复现或不完整的日志，大幅缩短问题定位周期。
3. 促进信任：通过脱敏报告，团队可以更透明地共享 Agent 行为记录，降低监管风险，也让社区或客户更放心使用基于 MCP 的服务。
4. 生态扩展：作为开源项目，它可能成为 MCP 服务器标准审计层的一部分，未来可集成更多威胁检测规则或与 SIEM 系统对接。

尽管项目目前功能有限，但其设计理念——以“飞行记录器”为隐喻，专业、轻量、可审计——对 MCP 社区和 AI Agent 开发者具有重要参考价值。后续迭代若能开放插件化规则引擎或支持多种传输协议（如 HTTP），有望成为 MCP 安全领域的基石工具。