Skip to main content
Glama
Apple HIG MCP Server

Apple HIG MCP Server

by Amo643
README.md
# Apple HIG MCP Server

[![npm version](https://img.shields.io/npm/v/@dark0nly/apple-hig-mcp.svg)](https://www.npmjs.com/package/@dark0nly/apple-hig-mcp)
[![npm downloads](https://img.shields.io/npm/dm/@dark0nly/apple-hig-mcp.svg)](https://www.npmjs.com/package/@dark0nly/apple-hig-mcp)
[![Smithery](https://smithery.ai/badge/@dark0nly/apple-hig-mcp)](https://smithery.ai/server/@dark0nly/apple-hig-mcp)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT)

Model Context Protocol (MCP) server providing LLMs direct access to Apple's Human Interface Guidelines (HIG) via live `developer.apple.com` Markdown endpoints.

## Features

- **Live Endpoints:** Fetches `.md` documents directly from Apple Developer CDN on demand.
- **Local Cache:** In-memory and disk cache (`~/.cache/apple-hig-mcp`) with 24-hour TTL.
- **Coverage:** 160+ topics spanning Foundations, Components, Patterns, Inputs, Technologies, and Platforms (iOS, macOS, visionOS, watchOS, tvOS).
- **Design Guidance:** Built-in heuristics for Liquid Glass layering, 44pt touch targets, continuous curvature (squircle), button hierarchies, and spring physics.
- **6 Tools:** Search, full topic retrieval, category listings, redesign checklists, and official asset links (Figma, SF Symbols).

## Tools

| Tool | Description |
|------|-------------|
| `search_hig` | Search 160+ topics, titles, descriptions, and synonyms (`liquid glass`, `buttons`, `haptics`). |
| `get_guideline` | Retrieve live Markdown documentation for any topic (`materials`, `buttons`, `color`, etc.). |
| `list_categories` | List main HIG categories and topic counts. |
| `list_topics` | List topics within a category with summaries. |
| `get_redesign_checklist` | Generate actionable HIG redesign & polish checklist (iOS, macOS, visionOS). |
| `get_design_resources` | Official links for Apple Figma kits, SF Symbols, and design templates. |

## Installation & Setup

### Method 1: Zero-Install via npx (Recommended)
Add directly to your MCP client configuration (`claude_desktop_config.json`, Antigravity `mcp_config.json`, or Cursor):

```json
{
  "mcpServers": {
    "apple-hig": {
      "command": "npx",
      "args": ["-y", "@dark0nly/apple-hig-mcp"]
    }
  }
}
```

Or install via Claude Code CLI in one command:
```bash
claude mcp add apple-hig -- npx -y @dark0nly/apple-hig-mcp
```

Or install via Smithery CLI:
```bash
npx -y @smithery/cli install @dark0nly/apple-hig-mcp --client claude
```

### Method 2: Global Install
```bash
npm install -g @dark0nly/apple-hig-mcp
```

Then reference the binary directly:
```json
{
  "mcpServers": {
    "apple-hig": {
      "command": "apple-hig-mcp"
    }
  }
}
```

### Method 3: From Source
```bash
git clone https://github.com/Amo643/apple-hig-mcp.git
cd apple-hig-mcp
npm install
npm run build
```

## Testing

```bash
node test.js
node test-mcp-stdio.js
```

## License

MIT

TDQS

A3.8/5.0

Scored across 6 tools

Disambiguation4/5

Each tool has a largely distinct role: search finds topics, get_guideline fetches full content, list_categories and list_topics navigate the hierarchy, and the checklist/resource tools are clearly separate utilities. The only mild overlap is between search_hig and get_guideline, since both retrieve guideline content, but their descriptions distinguish discovery from full retrieval.

Naming Consistency5/5

All tool names use consistent snake_case with a predictable verb_noun pattern: search_hig, get_guideline, list_categories, list_topics, get_redesign_checklist, get_design_resources. The naming is readable and uniform across the set.

Tool Count5/5

Six tools is well-scoped for a read-only Apple HIG reference server. Each tool covers a meaningful browsing, retrieval, or resource-access function without redundant entries.

Completeness4/5

The surface covers discovery, full-content retrieval, category/topic navigation, redesign checklists, and design resources, which is strong for a HIG reference server. Minor gaps remain, such as a global topic listing or richer cross-referencing between related guidelines, but core workflows are covered.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues