Cursormcpmonitor

🚀 光標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開源協議，代碼和文檔均可自由使用、修改和分發。

如需更多幫助，請訪問官方文檔或聯繫支持團隊。