HIG Doctor

HIG Doctor MCP サーバー

HIG Doctor をコーディングエージェントに接続する開発者向けのアクティブな MCP サーバーです。 HIG のスキルコーパスとソース監査を、構造化されたツールとして公開します。

ビルド後は Node 20 以降で、ソースから直接実行する場合は Bun で動作します。Claude Desktop、Cursor、Windsurf、Claude Code に対応しています。トランスポートは stdio（デフォルト）とストリーミング可能な HTTP（--http）です。

インストールと起動

npx hig-mcp

期待される結果：プロセスが MCP stdio サーバーを起動し、以下の 6 つの ツールを公開します。公開パッケージにはスキルコーパスが含まれています。

ツール

ツール	目的
hig_list_skills	説明と参照トピックとともに、利用可能なスキルを列挙します。コーパスを確認するため、最初に呼び出してください。
hig_lookup	HIG のリファレンス Markdown を取得します。スキル名（例：hig-foundations）またはスキルとトピック（例：skill=hig-foundations, topic=color）を指定します。
hig_search	すべての参照トピックを対象に、BM25 による全文検索を行います。自然言語で質問すると（例：「タッチターゲットの最小サイズ」）、スニペット付きで関連度順のトピックを取得できます。
hig_audit	プロジェクトディレクトリに対して HIG 準拠監査を実行します。重大度の件数、カテゴリごとの内訳、Markdown レポート、設定／ベースラインの状態、任意の fail_on ゲートを返します。
hig_audit_file	単一ファイルを監査します。コードの記述または編集後にすばやく確認するためのツールです。各検出結果について、ルール ID、重大度、行番号、修正ガイダンス、HIG の引用を返します。
hig_explain_finding	検出結果を説明します。ルールの完全なメタデータと、引用された Apple HIG リファレンスの抜粋を返します。監査結果の ruleId を渡してください。

各ツールはテキストミラーとともに structuredContent（解析済み JSON）を返すため、エージェントは構造化データを直接利用できます。コンテンツは 2025-02-02 時点の Apple の HIG に基づいています。Apple の最新の Human Interface Guidelinesが正式な参照先です。

チェックアウトから実行

git clone https://github.com/raintree-technology/hig-doctor.git
cd hig-doctor/packages/mcp
bun install            # or: npm install
bun src/index.ts       # run directly (no build), or:
npm run build && node dist/index.js

Claude Desktop の設定

~/Library/Application Support/Claude/claude_desktop_config.json を編集します。

{
  "mcpServers": {
    "hig-doctor": {
      "command": "npx",
      "args": ["-y", "hig-mcp"]
    }
  }
}

ローカルのチェックアウトを使う場合は、command／args を Bun のソース（bun /abs/path/packages/mcp/src/index.ts）またはビルド済み Node アーティファクト（node /abs/path/packages/mcp/dist/index.js）に指定してください。

ストリーミング可能な HTTP トランスポート

リモートまたは複数クライアントの構成では、stdio の代わりに HTTP 経由でサーバーを起動します。

hig-mcp --http 3845      # POST /mcp on the given port (default 3845)

各リクエストはステートレスに処理されるため、複数のクライアントから同時に安全に利用できます。

Cursor／Windsurf／Claude Code

いずれも各エディターの mcpServers 設定を通じて MCP stdio プロトコルに対応しています。command／args を npx hig-mcp、またはローカルチェックアウトの Bun／Node エントリーポイントに指定してください。

スキルディレクトリの解決

サーバーは次の順序でスキルコーパスを解決します。

1. $HIG_SKILLS_DIR — 明示的なオーバーライド（より新しいローカルコピーを指定）
2. <module-dir>/skills — ビルド済みアーティファクトと同じ場所にバンドル（npm 配布パッケージ）
3. モノレポの開発用レイアウト — ソースファイルからの ../../../skills
4. $PWD/skills — 現在の作業ディレクトリ

公開されている npm パッケージにはコーパスが dist/skills にバンドルされているため、$HIG_SKILLS_DIR が必要なのはオーバーライドする場合のみです。

入力の検証

スラッグ引数（skill、topic）は、ファイルシステムパスの構築に使う前に kebab-case の許可リスト（/^[a-z0-9-]+$/）に照らして検証されます。hig_audit.directory と hig_audit_file.file には絶対パスを指定する必要があります。無効な入力は、ファイルシステムにアクセスする前にエラーになります。

制限事項とサポートの範囲

監査ツールが提供するのは静的レビューの根拠であり、HIG への準拠、アクセシビリティ、デザインの品質を証明するものではありません。HTTP モードでは認証や TLS は追加されないため、適切なローカルまたは信頼できるトランスポート境界の内側に配置してください。プロジェクトガイド、 ベンチマーク、セキュリティポリシーを参照してください。

ライセンス

このパッケージは MIT ライセンスです。hig_lookup／hig_search が読み込む Apple HIG の参照コンテンツは © Apple Inc. に帰属します。完全な帰属表示については、リポジトリルートの THIRD_PARTY_NOTICES.md を参照してください。