Cursor MCP Monitor

基本能力

产品定位

Cursor MCP Monitor 是一个用于监控和调试 MCP 协议交互的工具，特别适用于在 Cursor AI 编辑器中进行 MCP 服务器与客户端通信的开发和调试。

核心功能

• 实时监控 MCP 客户端与服务器的交互，包括客户端创建、连接事件、服务器能力列表、协议错误和警告等。
• 监控 Cursor 日志目录中的新 MCP 日志文件。
• 解析并颜色编码不同类型的消息（绿色：客户端创建和成功连接；黄色：服务器能力列表；红色：协议错误和客户端关闭；灰色：一般信息消息）。
• 支持日志轮换和文件截断。
• 跨平台支持（Windows、macOS、Linux）。
• 智能错误处理，包括指数退避和重试逻辑。
• 可配置的轮询间隔和日志文件模式。
• 命令行界面，便于自定义。
• 结构化日志记录，使用 Serilog 提高可观察性。

适用场景

• 调试 MCP 服务器实现，监控客户端与服务器的交互。
• 分析协议消息和错误模式。
• 跟踪客户端生命周期和连接状态。
• 监控服务器能力和提供的服务。
• 验证协议实现的正确性。
• 通过结构化日志跟踪应用程序性能和错误率。

工具列表

• CursorMCPMonitor：主工具，用于监控和调试 MCP 交互。
• Serilog：用于结构化日志记录，提供丰富的日志上下文和输出格式。
• Docker：支持容器化部署和运行。

常见问题解答

• 如何安装？ 使用 .NET CLI 全局安装：dotnet tool install --global CursorMCPMonitor。
• 如何配置？ 通过 appsettings.json 或环境变量配置日志目录、轮询间隔等。
• 如何运行 Docker 容器？ 使用 docker run 命令并映射本地日志目录。

使用教程

使用依赖

• .NET 9.0 SDK 或更高版本：确保已安装 .NET SDK。

安装教程

# 从 NuGet.org 安装
dotnet tool install --global CursorMCPMonitor

# 或从 GitHub Packages 安装
dotnet nuget add source --name github "https://nuget.pkg.github.com/willibrandon/index.json"
dotnet tool install --global CursorMCPMonitor --add-source github

调试方式

# 运行工具并查看帮助
cursor-mcp --help

# 指定自定义日志目录
dotnet run -- --logs-root "C:\Users\username\AppData\Roaming\Cursor\logs"

# 设置自定义轮询间隔
dotnet run -- --poll-interval 500

# 使用不同的日志模式
dotnet run -- --log-pattern "Cursor MCP*.log"

# 设置日志级别
dotnet run -- --verbosity debug

# 过滤日志内容
dotnet run -- --filter "CreateClient"

Docker 支持

# 构建镜像
docker build -t cursor-mcp-monitor -f src/CursorMCPMonitor/Dockerfile .

# 运行容器（Windows PowerShell）
docker run -it --rm -v "$env:APPDATA\Cursor\logs:/app/logs" -e LogsRoot=/app/logs cursor-mcp-monitor

# 运行容器（macOS/Linux）
docker run -it --rm -v "$HOME/Library/Application Support/Cursor/logs:/app/logs" -e LogsRoot=/app/logs cursor-mcp-monitor

许可证

该项目遵循 MIT 开源许可条款。