Skip to content
appsgit

HIG Doctor

HIG Doctor is an MCP server that adds developer tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Apple Human Interface Guidelines search, lookup, and project audits for AI coding agents. It has 142 GitHub stars, is released under the MIT license and runs locally with npx -y hig-mcp.

github.com/raintree-technology/hig-doctor (opens in a new tab)

View on GitHub (opens in a new tab)Website (opens in a new tab)

Install HIG Doctor

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.json
{
  "mcpServers": {
    "hig-doctor": {
      "command": "npx",
      "args": [
        "-y",
        "hig-mcp"
      ],
      "env": {
        "HIG_SKILLS_DIR": "your-value"
      }
    }
  }
}

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

Claude Code

claude mcp add --env HIG_SKILLS_DIR=your-value --transport stdio hig-doctor -- npx -y hig-mcp

Cursor

.cursor/mcp.json
{
  "mcpServers": {
    "hig-doctor": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hig-mcp"
      ],
      "env": {
        "HIG_SKILLS_DIR": "your-value"
      }
    }
  }
}

Project file; use ~/.cursor/mcp.json to enable it in every project.

VS Code

.vscode/mcp.json
{
  "servers": {
    "hig-doctor": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "hig-mcp"
      ],
      "env": {
        "HIG_SKILLS_DIR": "your-value"
      }
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Environment variables

Variables the server reads at startup.

NameRequiredDescription
HIG_SKILLS_DIRNoOptional override for the skills directory. The published package bundles the HIG skills corpus, so this is only needed to point the server at a different or…

Tools (6)

Parsed from the Tools section of the README; check the repository for the current list.

  • hig_list_skills

    Enumerate available skills with descriptions and reference topics. Call first to discover the corpus.

  • hig_lookup

    Fetch HIG reference markdown. Provide a skill name (e.g. hig-foundations) or skill + topic (e.g.

  • hig_search

    BM25 full-text search across every reference topic. Ask in natural language (e.g.

  • hig_audit

    Run the HIG compliance audit on a project directory. Returns severity counts, per-category breakdown, a markdown…

  • hig_audit_file

    Audit a single file — the fast inner loop after writing or editing code.

  • hig_explain_finding

    Explain a finding: full rule metadata plus an excerpt of the cited Apple HIG reference.

About HIG Doctor

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

  • agent-skills
  • ai-agents
  • apple-design
  • claude-code
  • hig
  • human-interface-guidelines
  • ios
  • macos
  • swiftui
  • uikit

Similar MCP servers

More developer tools MCP servers

All Developer tools

FAQ

HIG Doctor FAQ

Still curious? Email info@appsgit.com.

What is HIG Doctor?

HIG Doctor is an MCP server that adds developer tools to AI assistants such as Claude Desktop, Claude Code and Cursor. Apple Human Interface Guidelines search, lookup, and project audits for AI coding agents. It has 142 GitHub stars, is released under the MIT license and runs locally with npx -y hig-mcp. The source code is at github.com/raintree-technology/hig-doctor.

How do I install the HIG Doctor MCP server?

Add the command npx -y hig-mcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is HIG Doctor free?

The server is open source under the MIT license, so running it is free. It does not declare any required API key.

Is HIG Doctor actively maintained?

The most recent commit was on Sep 4, 2026. The latest release is hig-doctor-v2.0.3, published Sep 4, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.