Cursormcpmonitor

🚀 Cursor MCP Monitor

The Cursor MCP (Machine Control Protocol) Monitor is a tool designed for monitoring and analyzing MCP protocol interactions. It assists developers in debugging MCP server implementations, analyzing protocol messages and error patterns, and tracking client lifecycles and connection statuses.

🚀 Quick Start

The Cursor MCP Monitor is a powerful tool for monitoring and analyzing MCP protocol interactions. It helps developers debug MCP server implementations, analyze protocol messages and error patterns, and track client lifecycles and connection statuses.

✨ Features

• Protocol Monitoring: Real-time tracking of client-server interaction operations.
• Logging: Automatic generation of structured logs for easy analysis and troubleshooting.
• Error Handling: Equipped with an exponential backoff algorithm for automatic recovery from temporary failures.
• File Polling: Supports file polling and truncation detection.
• Performance Monitoring: Provides detailed performance metrics and error rate statistics.

📦 Installation

Prerequisites

• .NET 9.0 SDK or higher

Install via NuGet

dotnet add package CursorMCPMonitor --version 1.0.0

📚 Documentation

Configuration Options

Environment Variable Configuration

Global configuration can be done through the following environment variables:

• CURSOR_LOGS_ROOT: Sets the root directory for logs, default is ./logs.
• CURSOR_POLL_INTERVAL: Sets the polling interval in milliseconds, default is 1000.
• CURSOR_LOG_PATTERN: Sets the log file matching pattern, default is CursorMCP*.log.

Configuration File Example

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

[Console]
Verbosity = info
ColorEnabled = true

[File]
EnableRotation = true
MaxFileSize = 1MB

Use Cases

• Debugging MCP server implementations.
• Analyzing protocol messages and error patterns.
• Monitoring server capabilities and service provision.
• Validating the correctness of protocol implementations.
• Analyzing application performance through structured logs.

Logging and Observability

Structured Log Format

Console Output Example:

[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: Processing CreateClient operation

File Output Example:

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: Processing CreateClient operation

Log Level Explanation

• debug: Debug information, detailed output of internal states.
• info: General information, records normal operations.
• warning: Warning information, indicates potential problems.
• error: Error information, records functional anomalies.
• critical: Severe errors, may cause system crashes.

Error Handling Mechanism

Common Errors and Solutions

Docker Deployment Guide

Build the Image

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

ENTRYPOINT ["dotnet", "run"]

Start the Container

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

📄 License

This project is licensed under the MIT open-source license. The code and documentation can be freely used, modified, and distributed.

For more help, please visit the official documentation or contact the support team.