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#

bash

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)#

CategoryCountExamplesMCP/Agent Connection3MCP Client Closed, Shell Parse Failure, Auth ExpiredCrash/Freeze3Startup White Screen, Plugin Crash, Memory OverflowAI/Agent Malfunction3Request Timeout, Completion Quality Drop, Agent LoopProxy/Network2Proxy Conflict, GFW BlockedConfig/Environment3Config Corruption, Python Not Found, Node.js ErrorFile/Sync2Sync Conflict, File Watcher Error

Related Tools#

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