mcpField
B
boot-doctor-mcp

boot-doctor-mcp

ローカル
github.com/pamela-0その他110 週間前に更新
リポジトリ

boot-doctor-mcp について

boot-doctor-mcpは、起動不能、画面表示なし、POST失敗を調べる技術者やPCユーザー向けのMCPサーバーです。固定ルールと出典のあるBIOSビープコード表を使い、故障部品を推測しません。

主な機能

  1. 01優先順付きのトラブルシューティング
  2. 02BIOSビープコードの検索
  3. 03AMIBIOSとAptioの表を区別
  4. 04未登録のビープパターンを報告

活用シーン

  1. 01起動しないPCの次の確認事項を選ぶ
  2. 02BIOSのビープ音列を調べる
  3. 03症状だけで部品故障と断定しない

MCP 対応

MCPクライアント向けに `diagnose_symptoms` と `lookup_beep_code` ツールを提供します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
  "mcpServers": {
    "pamela-0-boot-doctor": {
      "command": "uvx",
      "args": [
        "boot-doctor-mcp"
      ]
    }
  }
}
起動コマンドuvx boot-doctor-mcp

ローカルサーバーにはマシン上の実行環境（Node.js 18 以上など）が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypiboot-doctor-mcp0.1.0

ツール

2

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
fans_spinanyいいえ
powers_onbooleanはい
display_outputbooleanいいえ
tried_cmos_resetbooleanいいえ
fans_stay_runninganyいいえ
tried_minimal_configbooleanいいえ
tried_different_cable_or_monitorbooleanいいえ

詳細

boot-doctor-mcp

PyPI License: MIT

PC が起動しない、画面が表示されない、POST しない場合のトラブルシューティングに対応する、実用的な MCP サーバーです。ハードウェアの原因を LLM に推測させません。単純で決定論的なルールエンジンと、実際の出典に基づく BIOS ビープコード表を使用します。

LLM ではなく、決定論的な仕組みを採用する理由

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

ビープパターン（例："10 short"、"1 long, 2 short"、"continuous"）を、実際の出典に基づく BIOS ビープコード表と照合します。

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

コメント

Markdown 対応

MCP は初めてですか？

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。