Cursor MCP Monitor
About
Real-time monitoring tool for Model Context Protocol (MCP) interactions in Cursor AI editor. Track, analyze, and debug AI context exchanges between LLM clients and servers. Supports log rotation, pattern matching, and color-coded event visualization.
Details
- Author
- willibrandon
- GitHub stars
- 12
- Downloads
- 397
- Categories
- Developer Tools
Jump to
- Real-time monitoring of MCP client-server interactions in Cursor
- Parses and color‑codes different message types (green, yellow, red, gray)
- Web‑based dashboard at http://localhost:5050 with live event streaming
- Cross‑platform support (Windows, macOS, Linux)
- Configurable polling interval, log pattern, and verbosity
- Structured logging with Serilog (console + daily‑rotated files)
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Cursor MCP MonitorCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install globally via .NET CLI: dotnet tool install --global CursorMCPMonitor. Run with cursor-mcp --help. Override settings via command-line options (e.g., --logs-root, --poll-interval, --verbosity) or environment variables. Docker support is also available with volume mapping for logs.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"cursor mcp monitor": {
"CursorMCPMonitor": {
"command": "docker",
"args": [
"build",
"-t",
"cursor-mcp-monitor",
"-f",
"src/CursorMCPMonitor/Dockerfile",
"."
]
}
}
}
}McpServers
{
"CursorMCPMonitor": {
"command": "docker",
"args": [
"build",
"-t",
"cursor-mcp-monitor",
"-f",
"src/CursorMCPMonitor/Dockerfile",
"."
]
}
}Cursor MCP Monitor
A .NET console application that monitors Model Context Protocol (MCP) interactions in the Cursor AI editor. This tool helps developers debug and analyze MCP server-client communications by monitoring log files in real-time.
What is MCP?
The Model Context Protocol (MCP) is an open protocol that standardizes how applications provide context to LLMs. It follows a client-server architecture where:
- MCP Hosts (like Cursor) connect to multiple servers
- MCP Clients maintain 1:1 connections with servers
- MCP Servers expose specific capabilities through the standardized protocol
- Local Data Sources and Remote Services are accessed securely through MCP servers
Features
- Real-time monitoring of MCP client-server interactions in Cursor:
- Client creation and connection events
- Server offering listings and capabilities
- Protocol errors and warnings
- Client lifecycle transitions
- Monitors the Cursor logs directory for new MCP log files
- Parses and color-codes different message types:
- Green: Client creation and successful connections
- Yellow: Server offering listings
- Red: Protocol errors and client closures
- Gray: General information messages
- Supports log rotation and file truncation
- Cross-platform support (Windows, macOS, Linux)
- Smart error handling with exponential backoff and retry logic
- Configurable polling interval and log file patterns
- Command-line interface for easy customization
- Structured logging with Serilog for improved observability:
- Console logging with formatted output
- File logging with daily rotation
- Contextual properties (machine name, thread ID, etc.)
- Log level filtering and output customization
Interactive Dashboard
The application includes a web-based dashboard for monitoring and analysis, accessible at http://localhost:5050 when the application is running. The dashboard features real-time event streaming through WebSocket connections with automatic reconnection handling and event rate monitoring.
The terminal display shows timestamps with millisecond precision and color-coded message types for easy identification of different event types. Advanced search functionality includes text-based search with highlighting and keyboard shortcut support.
A command palette (Ctrl/Cmd + P) provides quick access to common actions:
- Clear logs (Ctrl/Cmd + K)
- Copy visible entries (Ctrl/Cmd + C)
- Toggle auto-scroll (Ctrl/Cmd + S)
- Focus search (/)
The dashboard includes status indicators for WebSocket connection state, active client count, and events per second. It supports both dark and light themes with system theme detection.
Installation
You can install the tool globally using the .NET CLI:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
