Apple Doc MCP

Apple Doc MCP

Um servidor Model Context Protocol (MCP) que fornece acesso direto à Documentação para Desenvolvedores da Apple dentro do seu assistente de codificação com IA. Nota: Ei pessoal, obrigado por conferir este MCP! Como venho trabalhando nele regularmente, está ficando muito caro construí-lo e melhorá-lo para funcionar em diferentes plataformas, tudo isso enquanto adiciono novos recursos (tokens não são baratos, viu).

Se você achar este MCP útil, eu realmente agradeceria se você clicasse no botão ❤️ Sponsor lá em cima, qualquer contribuição é apreciada! Obrigado.

📋 Changelog

Obrigado à equipe do Github pelo apoio! E obrigado @billibala, @theoddbrick, @christopherbattlefrontlegal por patrocinarem! Vocês são incríveis.

• O histórico completo de versões está em CHANGELOG.md.

• 1.9.6

  • CORREÇÃO IMPORTANTE: Simplificou o search_symbols para ser mais previsível para agentes de IA
  • Adicionou resolução exata de símbolos dentro do search_symbols para consultas como GridItem, View e ButtonStyle
  • Alterou o search_symbols para retornar resultados com símbolos primeiro, com artigos e guias separados em suas próprias seções
  • Corrigiu o comportamento de curingas para que a busca de fallback respeite os padrões * e ? em vez de degradar para correspondências simples de substring
  • Removeu mensagens de busca enganosas sobre downloads em segundo plano e indexação "abrangente"
  • Removeu caminhos de código de busca mortos ou não utilizados que adicionavam confusão sem melhorar os resultados
  • Corrigiu a inicialização do índice na primeira busca para que a busca de símbolos com cache termine de construir antes que os resultados sejam usados

• 1.9.1

  • Moveu os documentos em cache para .cache/ para manter o repositório limpo
  • Roteou o log do MCP para stderr para que o stdout do protocolo permaneça limpo (isso estava quebrando a busca de símbolos do codex)

Instalação

VS Code

1. Abra a Paleta de Comandos (Shift+Cmd+P).
2. Execute MCP: Add Server.
3. Quando solicitado o tipo de servidor, escolha npm.
4. Insira este pacote:

apple-doc-mcp-server

Claude Code:

claude mcp add apple-docs -- npx apple-doc-mcp-server@latest

OpenAI Codex:

codex mcp add apple-doc-mcp -- npx apple-doc-mcp-server@latest

Manual:

{
	"mcpServers": {
		"apple-docs": {
			"command": "npx",
			"args": ["apple-doc-mcp-server@latest"]
		}
	}
}

Local:

yarn install
yarn build

{
  "mcpServers": {
    "apple-docs": {
      "command": "node",
      "args": ["/absolute/path/to/apple-doc-mcp/dist/index.js"]
    }
  }
}

Dicas de Busca

• Use nomes exatos de API quando você os conhecer ("GridItem", "ButtonStyle", "View").
• Comece amplo (ex.: "tab", "animation", "gesture").
• Tente sinônimos ("sheet" vs "modal", "toolbar" vs "tabbar").
• Use curingas ("Grid*", "*Item", "Lazy*") para correspondência flexível.
• Use múltiplas palavras-chave ("tab view layout") para refinar os resultados.
• Se nada aparecer, execute novamente discover_technologies com uma palavra-chave diferente ou escolha outro framework.
• search_symbols retorna símbolos primeiro e lista artigos correspondentes separadamente.

Ferramentas Disponíveis

• discover_technologies – navegue/filtre frameworks antes de selecionar um.
• choose_technology – defina o framework ativo; necessário antes de buscar na documentação.
• current_technology – mostra a seleção atual e próximos passos rápidos.
• search_symbols – busca com símbolos primeiro, resolução de nomes exatos, suporte a curingas e resultados de artigos separados.
• get_documentation – abre documentação detalhada para um símbolo conhecido ou caminho de documentação.
• get_version – obtém informações da versão atual do servidor MCP.