Cursor Doctor
Diagnose and fix Cursor IDE errors with one command. Built from 77 real-world Chinese developer pain signals on V2EX — the tool that fixes what makes developers rage-quit Cursor.
When to Use
- Cursor crashes or freezes unexpectedly
- "MCP Client Closed" / "Agent execution failed" errors
- AI autocomplete or chat stops responding
- Cursor won't start after an update
- Git sync, proxy, or extension conflicts
How It Works
# Diagnose what's wrong
cursor-doctor diagnose
# Auto-fix all detected issues
cursor-doctor fix
# Show all known error signatures
cursor-doctor signatures
# Match a specific error message
cursor-doctor match "MCP client closed unexpectedly"
Error Coverage
| Category | Signatures | Typical Fix |
|---|---|---|
| MCP / Agent Connection | 3 | Extension reset + port check |
| Crash / Freeze | 3 | Cache clear + GPU disable |
| AI / Agent Malfunction | 3 | Model switch + token reset |
| Network / Proxy | 2 | Proxy bypass + cert renewal |
| Config / Environment | 3 | Settings.json restore |
| File / Sync | 2 | Reindex + lock file cleanup |
Install
git clone https://github.com/minirr890112-byte/cursor-doctor.git
cd cursor-doctor
pip install -e .