HIG Doctor

io.github.raintree-technologyPublished by GitHub account raintree-technologyv0.2.3Updated Oct 24, 2026

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

The publisher's own server: FlightSweeper

VerifiedSTDIODesktop onlyKnowledge & MemoryDeveloper Tools

Overview

AI-generated overview

Local MCP server that gives coding agents Apple Human Interface Guidelines search, lookup, and project compliance audits.

What you can do
  • List and read HIG reference material: enumerate skills, fetch a skill or topic, and run BM25 full-text search over the corpus
  • Audit code: run a HIG compliance audit on a project directory or a single file, with severity counts, per-category breakdown, and a markdown report
  • Explain findings: look up rule metadata and the cited Apple HIG excerpt for a rule ID returned by an audit
  • Return structured JSON alongside text so agents can consume results directly
When to use it
Useful when an assistant writes or reviews Apple platform UI code and should check it against the Human Interface Guidelines, or when you want quick HIG lookups and per-file audits inside Claude Desktop, Cursor, Windsurf, or Claude Code.
Requirements
Runs locally over stdio via npx hig-mcp; Node 20+ (after build) or Bun. Optional streamable HTTP mode with --http and a port. No authentication. The skills corpus is bundled; HIG_SKILLS_DIR optionally points at a different local copy. Audit tools require absolute paths.
Before you install
Audit results are static review evidence only and do not prove HIG conformance, accessibility, or design quality. The bundled HIG snapshot is dated 2025-02-02, and Apple's live guidelines remain canonical. HTTP mode adds no authentication or TLS, so keep it behind a trusted local boundary.

Installation

In SourceWeft

  1. Open HIG Doctor in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

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.

Source: packages/mcp/README.md at commit 3ec08f5

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.3LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Vercel integrations

FlightSweeper

app.vercel.flightsweeper-webmcpOfficial publisher

FlightSweeper is a remote MCP endpoint offering anonymous public tools, with its agent boundary documented separately.

Streamable HTTPWeb executable
Not indexed yetOct 24, 2026

DocPull

Published by GitHub account raintree-technology

Local MCP server that syncs public web sources into cited, versioned context packs and answers queries with exact source spans.

STDIODesktop only
Web Search & ScrapingNot validated yetNov 7, 2026