✨ Features

- 🎨 Complete Coverage: HIG design guidelines + Apple API documentation for iOS, macOS, watchOS, tvOS, visionOS
- ⚡ Smart Caching: Fast responses via intelligent caching with graceful degradation
- 🔍 Smart Search: Unified search across design and technical content
- 🤖 Enhanced Search: Advanced search combining design principles with technical implementation
- 📚 Pre-built Content: 113+ pre-processed Apple HIG sections for instant access

🚀 Quick Start

$3

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!

$3

``bash
npm install -g apple-dev-mcp
`

🔧 Configuration

Claude Desktop

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


Claude Code

`bash
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:
`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

$3

Design Guidelines Search
- search_human_interface_guidelines - Search Apple HIG with platform filters
- Returns full content (not snippets) for AI-friendly responses
- Covers all Apple platforms: iOS, macOS, watchOS, tvOS, visionOS

Technical Documentation Search
- search_technical_documentation - Search Apple API documentation
- Framework-specific searches (SwiftUI, UIKit, AppKit, etc.)
- Symbol and method lookups with code examples

Unified Search
- search_unified - Combined design + technical documentation search
- Cross-references design guidelines with implementation details
- Perfect for end-to-end development guidance

$3

Search Design Guidelines:
`json
{
"name": "search_human_interface_guidelines",
"arguments": {
"query": "Tab Bars",
"platform": "iOS"
}
}
`

Search Technical Documentation:
`json
{
"name": "search_technical_documentation",
"arguments": {
"query": "Button",
"framework": "SwiftUI"
}
}
`

Unified Search:
`json
{
"name": "search_unified",
"arguments": {
"query": "navigation",
"platform": "iOS"
}
}
`

🧪 Testing

`bash
npm test # Run test suite
npm test # 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 CONTRIBUTING.md 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

- MightyDillah for inspiration
- Apple Inc. for comprehensive design guidelines
- Model Context Protocol team
- Open source community for contributions

---

Built with ❤️ for the developer community

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