boot-doctor-mcp

boot-doctor-mcp

一个用于排查 PC 无法启动、无显示或无法 POST 问题的真实 MCP 服务。不让大模型猜测硬件故障原因——采用简单、确定性的规则引擎，以及真实且有来源的 BIOS 蜂鸣代码表。

为什么采用确定性规则，而不是大模型

没人想让语言模型幻觉出“你的 GPU 坏了”，但事实并非如此。硬件建议一旦出错，就会造成实际的金钱和时间损失，因此值得采用固定且可审计的规则集，而不是听起来似是而非的猜测。此工具给出的每条答案，都能追溯到真实来源或固定且可测试的规则——绝不会编造解释。

工具

diagnose_symptoms(powers_on, fans_spin=None, fans_stay_running=None, display_output=False, tried_cmos_reset=False, tried_minimal_config=False, tried_different_cable_or_monitor=False)

根据已尝试的操作，给出真实、按优先级排序的下一步排查措施——遵循真实技术人员采用的相同顺序：电源阶段 → CMOS 重置 → 最小配置测试 → 替换测试，并优先排除成本最低的可能性。它不会诊断出确切的损坏部件；实际维修往往仍需要用已知正常的部件进行替换测试，此工具会明确说明这一点，而不会假装仅凭症状匹配就能取代替换测试。

lookup_beep_code(bios_type, pattern)

根据真实且有来源的 BIOS 蜂鸣代码表查询蜂鸣模式（例如 "10 short"、"1 long, 2 short"、"continuous"）。

bios_type 的取值包括：

• ami_legacy — 经典 AMIBIOS
• ami_aptio — 现代 AMI Aptio（UEFI），特意单独列出：对于相同的蜂鸣次数，传统 AMIBIOS 和 Aptio 使用的代码确实不同；初学者排错指南常会把它们合并到一张表中，这是常见错误
• award_phoenix — Award/Phoenix BIOS

如果表中没有完全匹配的模式，返回的仍是真实信息，而不是捏造的猜测——现代主板越来越多不再配备扬声器，而是使用调试 LED，因此“无匹配项”本身就是诚实、真实的结果。

来源

蜂鸣代码数据通过实时查询和交叉比对获取（并非来自训练数据记忆），来源包括 IONOS 和 Thomas-Krenn。有一点需要如实说明：OEM（HP、Dell、ASUS 等）有时会自定义或扩展这些代码；现代主板也越来越多地完全省去扬声器，改用调试 LED——此处未涵盖的某种模式，并不一定意味着没有问题。

安装

pip install boot-doctor-mcp

添加到 MCP 客户端配置中（例如 Claude Code）：

claude mcp add boot-doctor-mcp -- boot-doctor-mcp

或者直接运行以进行本地测试：

python -m boot_doctor_mcp.server

技能

同一软件包中附带 SKILL.md，无需单独下载；它会教 Claude 何时以及如何正确使用这些工具（例如，绝不猜测 BIOS 类型，也绝不只凭症状就断言某个部件已损坏）。将其安装到你的项目中：

boot-doctor-mcp-install-skill

请在要启用该技能的项目根目录中运行；它会相对于当前目录写入 .claude/skills/boot-doctor-mcp/SKILL.md。

开发

pip install -e ".[dev]"
pytest