HIG Doctor

io.github.raintree-technology由 GitHub 帳號 raintree-technology 發布v0.2.3更新於 Oct 24, 2026

Apple Human Interface Guidelines search, lookup, and project audits for AI coding agents.

發布方自己的服務：FlightSweeper

已驗證STDIO僅桌面知識與記憶開發者工具

概覽

AI 產生的概覽

本機 MCP 伺服器，讓編碼助理搜尋、查閱 Apple 人機介面指南，並對專案進行合規稽核。

可以做什麼
  • 列出並讀取 HIG 參考資料：列舉技能、依技能或主題取得內容、對語料進行 BM25 全文檢索
  • 稽核程式碼：對專案目錄或單一檔案執行 HIG 合規稽核，回傳嚴重度統計、分類明細與 Markdown 報告
  • 解釋問題：依稽核回傳的規則 ID 查詢規則中繼資料與引用的 Apple HIG 摘錄
  • 除文字外同時回傳結構化 JSON，方便助理直接使用
適用情境
適合在助理撰寫或審查 Apple 平台介面程式碼時對照人機介面指南檢查，或在 Claude Desktop、Cursor、Windsurf、Claude Code 中快速查閱 HIG 並對單一檔案進行稽核。
執行需求
透過 npx hig-mcp 以 stdio 在本機執行；需要 Node 20+（建置後）或 Bun。可選用 --http 加埠號的串流 HTTP 模式。無需驗證。技能語料已隨套件提供，HIG_SKILLS_DIR 可選地指向其他本機副本。稽核工具要求絕對路徑。
安裝前請注意
稽核結果僅為靜態審查證據，不能證明符合 HIG、無障礙或設計品質。隨套件提供的 HIG 快照日期為 2025-02-02，Apple 線上指南仍為權威版本。HTTP 模式不提供驗證或 TLS，應置於可信任的本機邊界之後。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 HIG Doctor，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

[HIG Doctor]

HIG Doctor MCP server

Active MCP server for developers connecting HIG Doctor to coding agents. It exposes the HIG skills corpus and source audit as structured tools.

Runs under Node 20+ (after build) or Bun (directly from source). Works with Claude Desktop, Cursor, Windsurf, and Claude Code. Transports: stdio (default) and streamable HTTP (--http).

Install and start

bash
npx hig-mcp

Expected result: the process starts an MCP stdio server and advertises the six tools below. The published package includes the skills corpus.

Tools

ToolPurpose
hig_list_skillsEnumerate available skills with descriptions and reference topics. Call first to discover the corpus.
hig_lookupFetch HIG reference markdown. Provide a skill name (e.g. hig-foundations) or skill + topic (e.g. skill=hig-foundations, topic=color).
hig_searchBM25 full-text search across every reference topic. Ask in natural language (e.g. "minimum touch target size") and get ranked topics with snippets.
hig_auditRun the HIG compliance audit on a project directory. Returns severity counts, per-category breakdown, a markdown report, config/baseline status, and an optional fail_on gate.
hig_audit_fileAudit a single file — the fast inner loop after writing or editing code. Returns each finding with rule ID, severity, line, fix guidance, and HIG citation.
hig_explain_findingExplain a finding: full rule metadata plus an excerpt of the cited Apple HIG reference. Pass a ruleId from an audit result.

Every tool returns structuredContent (parsed JSON) alongside the text mirror, so agents can consume structure directly. Content is from Apple's HIG, snapshot dated 2025-02-02; Apple's live Human Interface Guidelines remain canonical.

Run from a checkout

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

Claude Desktop config

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

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

For a local checkout, point command/args at the Bun source (bun /abs/path/packages/mcp/src/index.ts) or the built Node artifact (node /abs/path/packages/mcp/dist/index.js).

Streamable HTTP transport

For remote or multi-client setups, start the server over HTTP instead of stdio:

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

Each request is handled statelessly, so concurrent clients are safe.

Cursor / Windsurf / Claude Code

All honor the MCP stdio protocol via each editor's mcpServers config. Point command/args at npx hig-mcp, or at the Bun/Node entry point of a local checkout.

Skills directory resolution

The server resolves the skills corpus in this order:

  1. $HIG_SKILLS_DIR — explicit override (point at a newer local copy)
  2. <module-dir>/skills — bundled alongside the built artifact (the npm distribution)
  3. Monorepo dev layout — ../../../skills from the source file
  4. $PWD/skills — current working directory

The published npm package bundles the corpus at dist/skills, so $HIG_SKILLS_DIR is only needed to override it.

Input validation

Slug arguments (skill, topic) are validated against a kebab-case allowlist (/^[a-z0-9-]+$/) before being used to construct filesystem paths. hig_audit.directory and hig_audit_file.file must be absolute paths. Invalid inputs throw before any filesystem access.

Limits and support boundary

The audit tools provide static review evidence; they do not prove HIG conformance, accessibility, or design quality. HTTP mode does not add authentication or TLS, so place it behind an appropriate local or trusted transport boundary. See the project guide, benchmark, and security policy.

License

MIT for this package. Apple HIG reference content read by hig_lookup/hig_search is © Apple Inc. — see the repository root THIRD_PARTY_NOTICES.md for the full attribution.

來源：packages/mcp/README.md，提交 3ec08f5

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v0.2.3最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Vercel 整合

FlightSweeper

app.vercel.flightsweeper-webmcp官方發布者

FlightSweeper 是遠端 MCP 端點，提供匿名公開工具，其代理邊界另行發布。

Streamable HTTP可網頁執行
尚未收錄Oct 24, 2026

DocPull

由 GitHub 帳號 raintree-technology 發布

本機 MCP 伺服器，將公開網頁來源同步為附引用的版本化脈絡包，並依精確來源片段回答查詢。

STDIO僅桌面
網頁搜尋與抓取尚未驗證Nov 7, 2026