cursor-doctor

Diagnose and fix Cursor IDE errors, crashes, and configuration issues. Covers 16 error signatures across 6 categories (MCP connections, crashes, AI failures, proxy/network, environment, sync). Built from 77+ real pain signals from Chinese developer communities (V2EX, CSDN).

cursor-doctor — Cursor IDE 故障诊断工具

Diagnose and fix Cursor IDE errors, crashes, and configuration issues with one command. Built from real pain signals mined from Chinese developer communities.

痛点来源 (Pain Signal Origins)

在 2026 年 4-5 月的中文开发者社区扫描中，Cursor IDE 报错/崩溃是 Top 3 最热话题：

• V2EX cursor 节点：15+ 讨论帖（Cursor 陨落、CLI 反代、模型限制）
• CSDN 技术博客：30+ 篇 Cursor 故障文章
• 来源覆盖：V2EX · CSDN · 掘金

Quick Start

pip install cursor-doctor

# Full diagnosis
cursor-doctor diagnose

# Auto-fix common issues
cursor-doctor fix

# Match error text to known signatures
cursor-doctor match --text "MCP Client Closed"

# List all known error signatures
cursor-doctor signatures

Error Categories (16 signatures)

Category	Count	Examples
MCP/Agent Connection	3	MCP Client Closed, Shell Parse Failure, Auth Expired
Crash/Freeze	3	Startup White Screen, Plugin Crash, Memory Overflow
AI/Agent Malfunction	3	Request Timeout, Completion Quality Drop, Agent Loop
Proxy/Network	2	Proxy Conflict, GFW Blocked
Config/Environment	3	Config Corruption, Python Not Found, Node.js Error
File/Sync	2	Sync Conflict, File Watcher Error

Related Tools

• claude-intel-monitor — 检测 Claude/GPT/DeepSeek 是否降智
• HermesMade — 自动化开发者痛点扫描平台