mcpspy
基于eBPF的MCP协议实时监控与安全分析工具
安装使用
复制下面这段提示词发给你的 AI（Claude / Cursor / TRAE / Codex / WorkBuddy 等），它会自动帮你完成安装：
帮我安装这个 AI Skill：mcpspy。 它的用途是：基于eBPF的MCP协议实时监控与安全分析工具 完整的 Skill 内容见：https://321skill.com/skills/mcpspy/raw/index.md 请读取该页面内容，如果是 SKILL.md 格式直接安装，如果是 README 提炼核心 prompt 后安装。
提示词包含完整的 Skill 内容链接，AI 读取后即可完成安装。你也可以 查看完整内容 确认无误。
使用示例
“我正在调试一个基于MCP的AI助手，它与一个工具服务器的连接似乎有问题，请帮我监控这个进程。” 它会指导你安装并运行MCPSpy，通过命令`sudo mcpspy --pid <你的进程PID>`来实时显示所有进出的MCP消息，帮助你快速定位是连接失败、消息格式错误还是工具调用超时等问题。
介绍
MCPSpy是一款专为Model Context Protocol（MCP）设计的底层监控工具，它利用eBPF技术直接在Linux内核层面捕获和分析MCP客户端与服务器之间的JSON-RPC 2.0通信。它能实时展示Stdio和HTTP/HTTPS（包括SSE）两种传输协议下的消息流，让原本黑盒的AI工具集成过程变得透明可视。
使用时，用户只需以root权限运行mcpspy命令，并指定要监控的进程PID或程序名，即可在终端中看到实时滚动的请求与响应消息，包括初始化、工具调用、通知等各类MCP事件，是调试和审计MCP集成的利器。
该工具非常适合需要深度集成或审计MCP服务的开发者、运维工程师和安全研究人员。他们可以利用MCPSpy排查通信故障、分析性能瓶颈、检测潜在的安全风险（如数据泄露或提示词注入），从而确保AI应用的可靠性与合规性。
需要注意的是，MCPSpy依赖Linux内核（5.15+）的eBPF功能，且必须拥有root权限才能运行。它主要用于开发和调试阶段，不建议在生产环境中长期开启。监控敏感数据时，请确保符合相关隐私和安全规定。
核心特点
与仅能解析日志或网络包的通用监控工具不同，MCPSpy是专为MCP协议设计的，能理解其JSON-RPC消息结构并进行语义化展示；同时，它利用eBPF在内核层进行无侵入式监控，无需修改MCP客户端或服务器代码，即可捕获所有通信。
注意事项
仅支持Linux系统，且需要root权限和较新的内核版本，无法在Windows、macOS或容器内（无特权）直接使用。
常见问题
MCPSpy能监控哪些MCP传输协议？
支持Stdio（标准输入输出）和HTTP/HTTPS（包括Server-Sent Events）两种主要的MCP传输协议。
使用MCPSpy需要修改我的MCP应用代码吗？
完全不需要。MCPSpy通过eBPF在内核层进行无侵入式监控，对应用透明。
给 AI 助手的安装指引
如果你的 AI 编程助手（Claude Code、Cursor、TRAE 等）能看到这个页面，把下面这段发给它即可自动完成安装：
请访问 https://321skill.com/skills/mcpspy/raw/index.md 读取 mcpspy 的原始 Skill 定义（Markdown 格式），按其中说明在我的环境里完成安装和配置。
AI 可直接读取的原始 Markdown 地址：/skills/mcpspy/raw/index.md（查看排版版本）