apple-dev-mcp

tmaasen/apple-dev-mcp

3.3

If you are the rightful owner of apple-dev-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Apple Dev MCP Server is a comprehensive Model Context Protocol server designed to provide complete Apple development guidance, combining Human Interface Guidelines with Technical Documentation for all Apple platforms.

Tools

  1. search_guidelines

    Search HIG content with enhanced keyword matching.

  2. get_component_spec

    Get detailed component specifications.

  3. get_design_tokens

    Get design system values like colors and typography.

  4. get_accessibility_requirements

    Get accessibility guidelines for components.

  5. get_technical_documentation

    Get Apple API documentation and symbols.

Apple Dev MCP Icon

🍎 Apple Dev MCP Server

Health Check npm version License: MIT Node.js

Complete Apple development guidance for AI assistants

Combines Human Interface Guidelines (design) with Technical Documentation (API reference) for all Apple platforms.

✨ Features

  • 🎨 Complete Coverage: HIG design guidelines + Apple API documentation for iOS, macOS, watchOS, tvOS, visionOS
  • ⚡ Ultra-Fast: Instant responses via pre-generated static content (no scraping delays)
  • 🔍 Smart Search: Unified search across design and technical content with wildcard support
  • 🤖 AI-Powered Tools: Fused guidance combining design principles with technical implementation
  • 🔄 Always Current: Auto-updated content every 4 months via GitHub Actions

🚀 Quick Start

Option 1: Claude Desktop Extension (Recommended)

  1. Download apple-dev-mcp.dxt from releases
  2. Double-click to install in Claude Desktop
  3. Restart Claude Desktop
  4. Start using Apple development guidance!

Option 2: Traditional Installation

npm install -g apple-dev-mcp

🔧 Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "Apple Dev": {
      "command": "node",
      "args": ["/usr/local/lib/node_modules/apple-dev-mcp/dist/server.js"]
    }
  }
}
Claude Code 
claude mcp add "Apple Dev" node /usr/local/lib/node_modules/apple-dev-mcp/dist/server.js
Cursor / Windsurf / VS Code

Create .cursor/mcp.json, windsurf config, or .vscode/mcp.json:

{
  "mcpServers": {
    "Apple Dev": {
      "command": "node", 
      "args": ["/usr/local/lib/node_modules/apple-dev-mcp/dist/server.js"]
    }
  }
}

Find your path: npm list -g apple-dev-mcp
Windows users: Replace with C:\Users\YourUsername\AppData\Roaming\npm\node_modules\apple-dev-mcp\dist\server.js

📖 Usage

Resources

hig://ios              # Complete iOS guidelines
hig://macos            # Complete macOS guidelines  
hig://buttons          # Button design guidelines
hig://accessibility    # Accessibility requirements
hig://ios/foundations  # iOS-specific foundations

Key Tools (13 available)

Search & Discovery

  • search_guidelines - Search HIG with platform/category filters
  • search_unified - Search both design and technical content
  • search_wildcard - Pattern search with * and ? wildcards

Design Guidance

  • get_component_spec - Detailed component specifications
  • get_design_tokens - Colors, spacing, typography values
  • get_accessibility_requirements - Accessibility guidelines

Technical Documentation

  • get_technical_documentation - Apple API docs with code examples
  • search_technical_documentation - Search frameworks and symbols

AI-Powered Fusion

  • generate_fused_guidance - Comprehensive design + technical guides
  • generate_implementation_guide - Step-by-step implementation guides

Example

{
  "name": "generate_fused_guidance",
  "arguments": {
    "component": "Button",
    "platform": "iOS", 
    "framework": "SwiftUI",
    "includeCodeExamples": true
  }
}

🧪 Testing

npm test                # Run test suite
npm run health-check    # Test functionality

# Interactive testing
npx @modelcontextprotocol/inspector apple-dev-mcp

🤝 Contributing

We welcome contributions! The most needed help:

  1. Scraper fixes when Apple changes their website
  2. New features and bug fixes
  3. Documentation improvements

See for guidelines.

⚖️ Legal & Attribution

This project operates under fair use principles for educational purposes. All content includes proper Apple attribution and respects their intellectual property.

Content sourced from Apple's Human Interface Guidelines.
© Apple Inc. All rights reserved. Provided for educational purposes.

🙏 Acknowledgments

Built with ❤️ for the developer community

Bringing Apple's design excellence directly to your AI-assisted development workflow.