apple-docs-mcp MCP — Casos de uso, Instalar & Demo ao vivo

Name: apple-docs-mcp MCP Server
Author: kimsungwhee

Por que usar

Principais recursos

Pesquise documentação Apple em SwiftUI, UIKit, Foundation, ARKit, Core ML, Metal, Vision
Busca de vídeos WWDC 2014-2025 com transcrições e exemplos de código
Busca de símbolos com escopo do framework
Compatibilidade de plataforma + rastreamento de depreciação
Índice de sessão WWDC agregado offline

Demo ao vivo

Como fica na prática

apple-docs.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ],
      "_inferred": true
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ],
      "_inferred": true
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ],
      "_inferred": true
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "apple-docs",
      "command": "npx",
      "args": [
        "-y",
        "apple-docs-mcp"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "apple-docs": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "apple-docs-mcp"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add apple-docs -- npx -y apple-docs-mcp

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: apple-docs-mcp

Como impedir que seu agente invente APIs SwiftUI

👤 Devs iOS usando Claude/Cursor ⏱ ~10 min beginner

Quando usar: O agente sugere APIs que não existem na versão iOS que você está direcionando.

Pré-requisitos

Node 18+ — nvm install 20

Fluxo

Instalar

Instale via: npx -y @kimsungwhee/apple-docs-mcp@latest (ou adicione à configuração MCP).✓ Copiado

→ Ferramentas aparecem
Fundamente sua pergunta

Use search_apple_docs para encontrar 'navigationDestination' e get_platform_compatibility para verificar se está disponível no iOS 16+.✓ Copiado

→ Entrada de doc oficial + alvo de implantação mínima
Cite no código

Agora escreva o código de navegação citando a documentação que acabou de ler.✓ Copiado

→ Código + citações

Resultado: Código que compila contra seu alvo de implantação.

Armadilhas

APIs exclusivas de WWDC mostradas antes do lançamento — Verifique get_platform_compatibility — APIs beta são sinalizadas

Combine com: github

Como encontrar a sessão WWDC que explica um recurso

👤 Devs iOS adotando um novo recurso ⏱ ~10 min beginner

Quando usar: Documentos são concisos; o contexto está em uma conversa WWDC que você não assistiu.

Fluxo

Pesquise WWDC

search_wwdc_videos 'Observation framework Swift macro' years=[2023,2024].✓ Copiado

→ Lista de sessão
Extrair transcrição + código

get_wwdc_video_details para o resultado principal. Extraia as amostras de código.✓ Copiado

→ Transcrição + trechos de código

Resultado: Contexto + código funcionando sem assistir ao vídeo.

Como planejar uma migração de uma API deprecada

👤 Devs iOS mantendo codebases mais antigos ⏱ ~10 min intermediate

Quando usar: Um aviso diz 'deprecado no iOS 17' e você quer a substituição.

Fluxo

Confirmar depreciação

get_platform_compatibility para UIActivityIndicatorView.startAnimating.✓ Copiado

→ Cronograma de disponibilidade
Encontre a substituição recomendada

find_similar_apis — qual é o equivalente SwiftUI?✓ Copiado

→ ProgressView() com argumentos apropriados

Resultado: Plano de migração confiante com referências.

Combine com: github

Combinações

Combine com outros MCPs para 10× de alavancagem

apple-docs + github

Fundamentar um PR de migração com documentos + referências WWDC

Encontre a substituição SwiftUI para nosso uso do ActivityViewController UIKit, cite documentos Apple e sessões WWDC, e elabore um PR de migração.✓ Copiado

apple-docs + filesystem

Verifique o código local para APIs deprecadas e sugira substituições

Grep meu Sources/ para qualquer API marcada como deprecada por apple-docs-mcp; produza uma lista de verificação de migração.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
search_apple_docs	query: str, platform?: str	Encontre qualquer API por nome ou tópico	free
get_apple_doc_content	url_or_id	Leia a página inteira após pesquisa	free
list_technologies	category?, include_beta?: bool	Procure frameworks	free
search_framework_symbols	framework, query	Busca de símbolos com escopo	free
get_related_apis	symbol	Travessia de herança/conformidade	free
get_platform_compatibility	symbol	Verificar disponibilidade	free
find_similar_apis	symbol	Substituições para APIs deprecadas	free
get_sample_code	topic?	Encontre projetos de exemplo da Apple	free
search_wwdc_videos	query, years?: int[], topics?: str[]	Encontre palestras WWDC	free
get_wwdc_video_details	session_id	Contexto de sessão completo	free

Custo e limites

O que custa rodar

Cota de API: developer.apple.com tem limites de taxa de uso razoáveis; ferramentas são armazenadas em cache para reduzir chamadas
Tokens por chamada: Docs: 500-3000 tokens. Transcrições: até 20k tokens para sessões longas
Monetário: Gratuito
Dica: Use search_framework_symbols em vez de search_apple_docs amplo para economizar tokens.

Segurança

Permissões, segredos, alcance

Escopos mínimos: Nenhum — apenas documentos públicos

Armazenamento de credenciais: Nenhum

Saída de dados: developer.apple.com + índice offline agregado

Nunca conceda: Nada para conceder

Documentos Apple são revisados sem notificação; respostas Claude podem ficar para trás do site ao vivo em alguns dias.

Solução de problemas

Erros comuns e correções

A pesquisa não retorna resultados

A consulta pode ser muito específica — tente apenas o nome da classe ou use list_technologies para procurar.

O conteúdo do doc parece truncado

Algumas páginas são grandes; a ferramenta trunca — passe o URL para get_apple_doc_content que lida com paginação.

Vídeo WWDC não encontrado

Algumas sessões mais antigas não são transcritas. Use search_wwdc_videos com filtro de anos.

Alternativas

apple-docs-mcp vs. outros

Alternativa	Quando usar	Troca
apple-docs via firecrawl	Você quer scraping bruto	Sem índice WWDC, sem estrutura
context7 MCP	Você quer documentação de biblioteca geral, não específica da Apple	Cobertura Apple mais fraca

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills