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