minirr890112-byte Cursor Doctor
Problem → Solution
The problem: Cursor crashes. "MCP Client Closed." "Applying edit failed." You search GitHub issues, V2EX threads, CSDN posts — 45 minutes later you're no closer to a fix. Meanwhile, Cursor just dropped a new pricing tier and you don't know if you're overpaying.
The solution: One command diagnoses your Cursor environment against 28 known error signatures sourced from 156 V2EX + 85 CSDN discussions. Auto-fix for common issues. Pricing matrix compares all 4 Cursor plans. Migration guide for the 500-limit changes.
Quick Start
pip install git+https://github.com/minirr890112-byte/cursor-doctor.git
cursor-doctor diagnose # Full health check
cursor-doctor fix # Auto-fix common issues
cursor-doctor pricing # Plan comparison matrix
cursor-doctor migrate # 500-limit → unlimited guide
cursor-doctor signatures # Browse 28 error signatures
Real Output
$ cursor-doctor diagnose
🩺 Cursor Doctor v1.2.0 — Diagnostic Report
────────────────────────────────────────────
✅ Cursor Version: 0.48.3 (latest)
✅ System: macOS 15.3, Python 3.12
⚠️ MCP Connection: 2 recent disconnects
❌ Extension Crash: 1 crash in last 24h
────────────────────────────────────────────
Health Score: 72/100 ⚠️
Recommendation: Run 'cursor-doctor fix mcp_connection'
10 Error Categories (28 signatures)
| Category | Count | Top Signature |
|---|---|---|
| MCP Connection | 5 | "MCP Client Closed" |
| Crash/Freeze | 4 | "Window not responding" |
| Network/Proxy | 3 | "Failed to fetch" |
| Config/Env | 3 | "Extension host terminated" |
| Pricing/Billing | 4 | "Usage limit reached" |
| Performance | 3 | "High memory usage" |
| Update | 2 | "Update failed" |
| Account | 2 | "Login expired" |
| Edit/Apply | 1 | "Apply edit failed" |
| Composer | 1 | "Composer unavailable" |
⭐ Star this repo if it fixed your Cursor: github.com/minirr890112-byte/cursor-doctor