boot-doctor-mcp

Un servidor MCP real para solucionar problemas de PC que no arranca / sin imagen / sin POST. Nada de LLM adivinando causas de hardware — un motor de reglas determinista y sencillo, más tablas reales de códigos de pitido del BIOS con fuentes.

Por qué determinista y no un LLM

Nadie quiere que un modelo de lenguaje alucine «tu GPU está muerta» cuando no es así. El asesoramiento sobre hardware donde equivocarse cuesta dinero y tiempo reales merece un conjunto de reglas fijo y auditable, no una suposición que suene plausible. Cada respuesta que da esta herramienta se remonta a una fuente real o a una regla fija y comprobable — nunca a una explicación inventada.

Related MCP server: System Information MCP Server

Herramientas

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)

Pasos reales y ordenados de solución de problemas, teniendo en cuenta lo que ya se ha probado — la misma secuencia de etapa de alimentación → reinicio de CMOS → prueba de configuración mínima → prueba de intercambio que ejecuta un técnico real, ordenada por lo que es más barato descartar primero. No es un diagnóstico de la pieza exacta averiada; una reparación real a menudo sigue necesitando una prueba de intercambio con piezas que se sabe que funcionan, y esta herramienta lo dice explícitamente en lugar de fingir que el simple emparejamiento de síntomas puede sustituirlo.

lookup_beep_code(bios_type, pattern)

Busca un patrón de pitidos (p. ej. "10 short", "1 long, 2 short", "continuous") en tablas reales de códigos de pitido del BIOS con fuentes.

bios_type es uno de:

• ami_legacy — AMIBIOS clásico

• ami_aptio — AMI Aptio moderno (UEFI), mantenido separado a propósito: el AMIBIOS heredado y Aptio usan códigos genuinamente diferentes para los mismos conteos de pitidos, un error común en guías de solución de problemas para principiantes que los fusionan en una sola tabla

• award_phoenix — BIOS Award/Phoenix

Devuelve información real, no una suposición fabricada, cuando el patrón exacto no está en la tabla — las placas modernas cada vez más no tienen altavoz en absoluto y usan LED de depuración en su lugar, por lo que «sin coincidencia» es en sí mismo un resultado real y honesto.

Fuentes

Datos de códigos de pitido obtenidos y contrastados en vivo (no de la memoria de datos de entrenamiento) de IONOS y Thomas-Krenn. Limitación real y declarada: los OEM (HP, Dell, ASUS, etc.) a veces personalizan o amplían estos códigos, y las placas modernas omiten cada vez más el altavoz en favor de los LED de depuración — que un patrón documentado no coincida aquí no significa necesariamente que no haya nada malo.

Instalación

pip install boot-doctor-mcp

Añádelo a la configuración de tu cliente MCP (p. ej. Claude Code):

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

O ejecútalo directamente para pruebas locales:

python -m boot_doctor_mcp.server

Desarrollo

pip install -e ".[dev]"
pytest