Apple HIG

🍎 Apple Dev MCP Server

Orientação completa de desenvolvimento Apple para assistentes de IA

Combina as Human Interface Guidelines (design) com a Documentação Técnica (referência de API) para todas as plataformas Apple.

✨ Recursos

• 🎨 Cobertura Completa: Diretrizes de design HIG + documentação da API Apple para iOS, macOS, watchOS, tvOS, visionOS
• ⚡ Cache Inteligente: Respostas rápidas via cache inteligente com degradação graciosa
• 🔍 Busca Inteligente: Busca unificada em conteúdo de design e técnico
• 🤖 Busca Aprimorada: Busca avançada combinando princípios de design com implementação técnica
• 📚 Conteúdo Pré-construído: Mais de 113 seções de HIG da Apple pré-processadas para acesso instantâneo

🚀 Início Rápido

Opção 1: Extensão Claude Desktop (Recomendada)

1. Baixe apple-dev-mcp.dxt de versões
2. Clique duas vezes para instalar no Claude Desktop
3. Reinicie o Claude Desktop
4. Comece a usar a orientação de desenvolvimento Apple!

Opção 2: Instalação Tradicional

npm install -g apple-dev-mcp

🔧 Configuração

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

claude mcp add "Apple-Dev" node /usr/local/lib/node_modules/apple-dev-mcp/dist/server.js

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

Encontre seu caminho: npm list -g apple-dev-mcp
Usuários Windows: Substitua por C:\Users\YourUsername\AppData\Roaming\npm\node_modules\apple-dev-mcp\dist\server.js

📖 Uso

Ferramentas Disponíveis (3 ferramentas principais)

Busca de Diretrizes de Design

• search_human_interface_guidelines - Busque HIG da Apple com filtros de plataforma
  • Retorna conteúdo completo (não trechos) para respostas amigáveis à IA
  • Cobre todas as plataformas Apple: iOS, macOS, watchOS, tvOS, visionOS

Busca de Documentação Técnica

• search_technical_documentation - Busque documentação da API Apple
  • Buscas específicas por framework (SwiftUI, UIKit, AppKit, etc.)
  • Consultas de símbolos e métodos com exemplos de código

Busca Unificada

• search_unified - Busca combinada de design + documentação técnica
  • Cruza diretrizes de design com detalhes de implementação
  • Perfeito para orientação de desenvolvimento de ponta a ponta

Exemplos

Buscar Diretrizes de Design:

{
  "name": "search_human_interface_guidelines",
  "arguments": {
    "query": "Tab Bars",
    "platform": "iOS"
  }
}

Buscar Documentação Técnica:

{
  "name": "search_technical_documentation",
  "arguments": {
    "query": "Button",
    "framework": "SwiftUI"
  }
}

Busca Unificada:

{
  "name": "search_unified",
  "arguments": {
    "query": "navigation",
    "platform": "iOS"
  }
}

🧪 Testes

npm test                # Run test suite
npm test               # Test functionality

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

🤝 Contribuindo

Aceitamos contribuições! A ajuda mais necessária:

1. Correções de scraper quando a Apple muda seu site
2. Novos recursos e correções de bugs
3. Melhorias na documentação

Veja CONTRIBUTING.md para diretrizes.

⚖️ Legal e Atribuição

Este projeto opera sob princípios de uso justo para fins educacionais. Todo o conteúdo inclui atribuição adequada à Apple e respeita sua propriedade intelectual.

Conteúdo proveniente das Human Interface Guidelines da Apple.
© Apple Inc. Todos os direitos reservados. Fornecido para fins educacionais.

🙏 Agradecimentos

• MightyDillah pela inspiração
• Apple Inc. pelas diretrizes de design abrangentes
• Equipe do Model Context Protocol
• Comunidade de código aberto pelas contribuições

Feito com ❤️ para a comunidade de desenvolvedores

Trazendo a excelência de design da Apple diretamente para seu fluxo de trabalho de desenvolvimento assistido por IA.