基本能力
产品定位
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。
安装教程
```bash
从 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
```
调试方式
```bash
运行工具并查看帮助
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 支持
```bash
构建镜像
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
```
