🚀 光标MCP监视器

光标MCP（Machine Control Protocol）监视器是一款用于监控和分析MCP协议交互的工具。它能助力开发者调试MCP服务器实现，分析协议消息与错误模式，还可跟踪客户端生命周期和连接状态。

🚀 快速开始

光标MCP监视器可帮助开发者高效调试MCP服务器，分析协议消息和错误模式。以下将为你介绍其安装、配置和使用方法。

✨ 主要特性

• 协议监控：实时跟踪客户端和服务端的交互操作。
• 日志记录：自动生成结构化日志，便于分析和排查问题。
• 错误处理：具备指数退避算法，自动恢复临时故障。
• 文件轮询：支持文件轮询和截断检测。
• 性能监控：提供详细的性能指标和错误率统计。

📦 安装指南

先决条件

• .NET 9.0开发工具包或更高版本

使用NuGet安装

dotnet add package CursorMCPMonitor --version 1.0.0

📚 详细文档

配置选项

环境变量配置

可以通过以下环境变量进行全局配置：

• CURSOR_LOGS_ROOT：设置日志根目录，默认为./logs。
• CURSOR_POLL_INTERVAL：设置轮询间隔（以毫秒为单位），默认为1000。
• CURSOR_LOG_PATTERN：设置日志文件匹配模式， 默认为CursorMCP*.log。

配置文件示例

[Global]
LogsRoot = ./logs
PollInterval = 1000
LogPattern = CursorMCP*.log

[Console]
Verbosity = info
ColorEnabled = true

[File]
EnableRotation = true
MaxFileSize = 1MB

使用场景

• 调试MCP服务器实现。
• 分析协议消息和错误模式。
• 监控服务端能力和服务提供情况。
• 验证协议实现的正确性。
• 通过结构化日志分析应用性能。

日志记录与可观测性

结构化日志格式

控制台输出示例：

[2025-03-03 12:34:56.789] [INF] [CursorMCPMonitor.Services.LogProcessorService] CreateClient detected: Cursor MCP.log 2025-03-03 12:34:56.123 [info] a602: 处理CreateClient操作

文件输出示例：

2025-03-03 12:34:56.789 +00:00 [INF] [CursorMCPMonitor.Services.LogProcessorService] CreateClient detected: Cursor MCP.log 2025-03-03 12:34:56.123 [info] a602: 处理CreateClient操作

日志级别说明

• debug：调试信息，详细输出内部状态。
• info：一般信息，记录正常操作。
• warning：警告信息，提示潜在问题。
• error：错误信息，记录功能异常。
• critical：严重错误，可能导致系统崩溃。

错误处理机制

常见错误及解决方法

Docker部署指南

构建镜像

FROM mcr.microsoft.com/dotnet/runtime:7.0.0-alpine AS base
WORKDIR /app
COPY . .

ENTRYPOINT ["dotnet", "run"]

启动容器

docker build -t cursor-mcp-monitor .
docker run --name cursor-mcp-monitor -p 5000:5000 cursor-mcp-monitor

📄 许可证

本项目遵循MIT开源协议，代码和文档均可自由使用、修改和分发。

如需更多帮助，请访问官方文档或联系支持团队。