Apple Docs 2.0 MCP

English · 日本語 · 한국어 · 简体中文

Apple Docs 2.0 MCP

Um MCP para a documentação de desenvolvedor da Apple, diretrizes de design e sessões da WWDC.

Construindo seu próximo app iOS com um agente? Deixe-o ler os próprios documentos da Apple primeiro: menos reescritas, menos interrupções.

Início Rápido · Novidades · Instalação · Uso · Ferramentas · Arquitetura · Desenvolvimento

npx -y apple-docs-2.0-mcp

Documentação de Desenvolvedor da Apple para assistentes de IA, através do Model Context Protocol: referência de API, artigos, código de exemplo, tutoriais, as Diretrizes de Interface Humana, Ajuda do App Store Connect, as APIs de serviço web (App Store Connect API, App Store Server API e outras) e 1.700 sessões da WWDC com suas transcrições e código, no Claude, Cursor, VS Code ou qualquer cliente MCP.

Apple Docs 2.0 MCP é um fork do Apple Docs MCP por kimsungwhee, melhorado com adições, correções e uma nova ferramenta.

🚀 Início Rápido

Claude Desktop (Recomendado)

Adicione isto à sua configuração do Claude Desktop:

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

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

Nota: Se você encontrar problemas com uma versão antiga sendo usada, adicione @latest para forçar a versão mais recente:

"args": ["-y", "apple-docs-2.0-mcp@latest"]

Reinicie o Claude Desktop e comece a perguntar sobre APIs da Apple!

Claude Code

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

Pergunte ao seu agente

Look up NavigationStack in Apple's docs, then show me the WWDC code that uses it.

🆕 Novidades na Versão 2.0

O Apple Docs 2.0 MCP mantém todas as ferramentas do Apple Docs MCP 1.0.26 e corrige o que parou de funcionar ou voltou incompleto, para que seu assistente responda com base na documentação oficial da Apple em vez de adivinhar.

🔍 Busca que retorna resultados

search_apple_docs está corrigido: agora usa o mesmo serviço de busca que o site da Apple usa, então seu assistente obtém os resultados que você veria em developer.apple.com: referência de API, artigos, código de exemplo, diretrizes de design, Ajuda do App Store Connect e vídeos da WWDC. No original, as buscas voltam vazias desde que a Apple mudou sua página de busca.

Pergunte sobre uma API, uma diretriz de design ou um processo do App Store, e o assistente busca primeiro, depois lê as páginas que encontrar.

🗺️ Consulte qualquer página pelo nome

Uma nova ferramenta, search_docs_map, encontra qualquer uma das 336.629 páginas pelo nome, ou parte dele, offline:

• Símbolos de API: tipos, métodos, propriedades, casos de enum, macros
• artigos, tutoriais e código de exemplo
• chaves de Info.plist e entitlement
• endpoints de serviço web, como os da App Store Connect API
• páginas das Diretrizes de Interface Humana e da Ajuda do App Store Connect

Use-a quando você já souber um nome, vindo de código ou de uma mensagem de erro, para abrir sua página diretamente.

📄 Páginas de documentação completas

As páginas chegam inteiras, como no site da Apple: cada método e propriedade com sua assinatura completa (var view: UIView!, não apenas view), o que um tipo herda e a que conforma, APIs relacionadas e as versões de SO que o suportam. A versão 2.0 também lê as Diretrizes de Interface Humana, tutoriais, Ajuda do App Store Connect e endpoints da App Store Connect API com seus parâmetros e respostas.

Pergunte sobre qualquer API, diretriz ou tópico do App Store Connect, e o assistente lê a página completa antes de responder ou escrever código.

🎥 WWDC 2014–2026, com código

1.700 sessões estão incluídas, WWDC26 incluso, e funcionam offline: transcrições para 1.416 delas e exemplos de código para 715, cada exemplo com o tempo em que aparece no vídeo. As sessões são arquivadas sob os mesmos tópicos do site da Apple.

Pergunte como uma nova API funciona, e o assistente pode citar a sessão da WWDC que a introduziu, com seu código.

📋 Listas completas de frameworks

A lista de tecnologias do original parava em 200 entradas, então categorias inteiras (Graphics and Games, Media, System, Web) nunca apareciam, e sua busca de símbolos misturava cabeçalhos com links quebrados. A versão 2.0 lista tudo, marca frameworks em beta e encontra frameworks por assunto: "Machine learning" retorna Core ML, Create ML, Foundation Models, Vision e mais.

Pergunte quais frameworks se adequam a uma tarefa, como machine learning ou áudio, e o assistente compara a lista completa.

🛠️ Feito para continuar funcionando

Dependências atualizadas, requisições que parecem de um navegador normal e esperam sua vez (a Apple retorna buscas vazias quando chegam rápido demais), novas tentativas automáticas quando uma requisição falha e 255 testes automatizados. Todos os 63 exemplos de uso no README do original rodam sem erros.

Nada para configurar: sem chave de API ou conta.

✨ Recursos

• 🔍 Busca: documentação da Apple, diretrizes de design, código de exemplo, Ajuda do App Store Connect e sessões da WWDC em uma única busca, ou apenas uma delas
• 🗺️ Mapa de documentos: encontre qualquer página pelo título, até mesmo um método ou nome de propriedade, sem requisição de rede
• 📚 Páginas de documentação: APIs Swift e Objective-C, artigos, tutoriais e referências de serviço web como Markdown
• 🎨 Diretrizes de Interface Humana: todas as páginas da HIG, pesquisáveis e legíveis
• 🏪 Ajuda do App Store Connect: campos de página de produto, análise, TestFlight, preços
• 🔧 Símbolos de frameworks: navegue pelas classes, structs, protocolos e membros de um framework por curinga
• 🔗 Relacionamentos de API: APIs relacionadas, semelhantes e referenciadas, e substituições para as obsoletas
• 📊 Compatibilidade de plataforma: a versão que introduziu e tornou obsoleta uma API em cada plataforma
• 📋 Catálogo de tecnologias: todos os frameworks e tecnologias da Apple por categoria, com os beta marcados
• 📰 Atualizações de documentação: notas de versão, atualizações de frameworks e páginas "O que há de novo" da WWDC
• 🎯 Visões gerais de tecnologia: guias da Apple para design de apps, jogos, IA e machine learning, dados e mais
• 💻 Código de exemplo: projetos de exemplo da Apple com seus resumos e links de Download
• 🎥 Biblioteca WWDC: 1.700 sessões de 2014 a 2026 com transcrições, exemplos de código com tempo, recursos e sessões relacionadas, offline

📦 Instalação

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

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

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

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

💬 Exemplos de Uso

🔍 Busca

"Search for SwiftUI animations"
"Find withAnimation API documentation"
"Search the Human Interface Guidelines for tab bars"
"Search App Store Connect Help for TestFlight external testers"
"Find sample code for Core Data"

🗺️ Mapa de Documentos

"Find the page for accessibilityInputLabels"
"Which SwiftUI pages have gauge in their title?"
"Find the App Store Connect API endpoint to create an auto-renewable subscription"

📚 Acesso à Documentação

"Get detailed information about the SwiftUI framework"
"Show me withAnimation API with related APIs"
"Show me NSManagedObjectContext documentation"
"Read the Human Interface Guidelines page on tab bars"
"Show the steps of the SwiftUI tutorial"

🔧 Exploração de Frameworks

"Show me SwiftUI views"
"List all UIKit delegate protocols"
"Get WeatherKit API hierarchy"
"Explore Core ML model loading APIs"

🔗 Descoberta de API

"Find APIs related to UIViewController"
"Discover alternatives to UIAlertView"
"Get all references from SwiftData documentation"
"Get platform compatibility for SwiftData"

📋 Tecnologias, Atualizações e Visões Gerais

"What machine learning frameworks are available?"
"Which technologies are in beta?"
"What's new in SwiftUI?"
"Show me release notes for Xcode"
"Get data management technology overviews"

💻 Código de Exemplo

"Show SwiftUI sample code projects"
"Find sample code for machine learning"
"Get the Food Truck sample"

🎥 WWDC

"Search WWDC videos about SwiftUI"
"Find WWDC sessions on machine learning"
"Show me WWDC 2026 videos"
"Search WWDC transcripts for async/await"
"Show me the transcript for WWDC23 Meet SwiftData"
"Get code examples from WWDC sessions that use SwiftData"
"Find sessions related to WWDC23 Meet SwiftData"
"List all WWDC topics"

🛠️ Ferramentas Disponíveis

As ferramentas de documentação buscam em developer.apple.com; as ferramentas da WWDC leem os dados incluídos e search_docs_map lê o mapa de documentos, ambos sem requisição de rede.

🏗️ Arquitetura

Apple-Docs-2.0-MCP/
├── src/
│   ├── index.ts                    # MCP server and its search guide
│   ├── tools/
│   │   ├── handlers.ts             # Tool registration
│   │   ├── search-api.ts           # Apple's search API
│   │   ├── search-docs-map.ts      # Docs map search
│   │   ├── doc-fetcher.ts          # Pages from Swift-DocC JSON
│   │   ├── doc-formatter.ts        # Markdown rendering
│   │   ├── help-pages.ts           # App Store Connect Help (jsdom, turndown)
│   │   ├── list-technologies.ts    # Technology catalog
│   │   ├── search-framework-symbols.ts
│   │   ├── get-related-apis.ts, find-similar-apis.ts, resolve-references-batch.ts, get-platform-compatibility.ts
│   │   ├── get-documentation-updates.ts, get-technology-overviews.ts, get-sample-code.ts
│   │   └── wwdc/                   # WWDC tools and the session, topic and year extractors
│   ├── types/                      # Generated from Swift-DocC's specs and captured responses
│   └── utils/                      # HTTP client, caches, constants, URL conversion
├── scripts/
│   ├── add-wwdc-year.ts            # Adds or refreshes a WWDC year in data/wwdc
│   ├── build-docs-map.ts           # Builds api-map/apple-docs-map.tsv
│   └── capture-responses.ts        # Captures responses to type them
├── data/wwdc/                      # The bundled WWDC sessions
├── api-map/                        # The docs map, Apple's search API (OpenAPI) and captured responses
└── tests/                          # Vitest

🌐 Requisições e Cache

Toda requisição passa por um único cliente HTTP: fetch com cabeçalhos de um Safari, no máximo 100 requisições por minuto, e buscas uma de cada vez, com 15 segundos de intervalo, já que a Apple responde buscas mais rápidas sem resultados. Cada tentativa tem um timeout de 2 minutos, com até 3 novas tentativas e backoff em erros de rede, timeouts e respostas 5xx.

📦 Dados da WWDC

As sessões da WWDC estão incluídas em data/wwdc/, então as ferramentas da WWDC funcionam offline e sem limites de taxa:

• 📹 1.700 sessões de 2014 a 2026, 1.416 com transcrições e 715 com exemplos de código
• 🏷️ 19 tópicos, retirados das páginas de tópicos da Apple
• 💾 41 MB de JSON

npx tsx scripts/add-wwdc-year.ts <year> adiciona um ano, ou o atualiza, a partir das páginas da Apple; uma sessão que a Apple não lista mais mantém seus dados armazenados.

🗺️ Mapa de Documentos

api-map/apple-docs-map.tsv lista 336.629 páginas (URL, título, tipo, tecnologia, grupo e árvore) dos índices de navegação da Apple, das Diretrizes de Interface Humana e da navegação da Ajuda do App Store Connect. search_docs_map o lê a cada chamada. npx tsx scripts/build-docs-map.ts api-map/apple-docs-map.tsv o reconstrói em cerca de 10 minutos.

🧪 Desenvolvimento

git clone https://github.com/mishafyi/Apple-Docs-2.0-MCP.git
cd Apple-Docs-2.0-MCP
npx pnpm@10 install
npx pnpm@10 run build          # tsc into dist/, then the WWDC data into dist/data/

# Run your build in Claude Code in place of the npm package
claude mcp add apple-docs -- node "$PWD/dist/index.js"

# Checks: types (server and scripts), lint and tests
npx tsc --noEmit && npx tsc -p scripts && npx eslint src scripts && npx vitest run

# Call the built server without an MCP client
npx -y @modelcontextprotocol/inspector --cli node dist/index.js --method tools/call \
  --tool-name search_apple_docs --tool-args-json '{"query":"tab bars","type":"design"}'

# Regenerate the types of Apple's JSON
npm run types:docc             # from Swift-DocC's RenderNode and RenderIndex specs
npm run types:captured         # from captured responses (quicktype)

Após uma compilação, reinicie ou reconecte o servidor no seu cliente MCP.

🙏 Créditos

Apple Docs 2.0 MCP é construído sobre o Apple Docs MCP por kimsungwhee, cujas ferramentas, dados da WWDC e estrutura serviram como ponto de partida.

🤝 Contribuindo

Contribuições são bem-vindas:

1. Faça um fork do repositório
2. Crie um branch de funcionalidade: git checkout -b feature/amazing-feature
3. Faça commit das suas alterações: git commit -m 'Add amazing feature'
4. Envie para o branch: git push origin feature/amazing-feature
5. Abra um Pull Request

📄 Licença

Licença MIT, assim como o projeto original: veja LICENSE.

⚠️ Aviso

Este projeto não é afiliado ou endossado pela Apple Inc. Ele lê a documentação pública de desenvolvedor da Apple para fins educacionais e de desenvolvimento.