Apple Developer Documentation

Apple Docs MCP - Servidor de Protocolo de Contexto do Modelo para Documentação de Desenvolvedor Apple

Servidor MCP de Documentação de Desenvolvedor Apple - Acesse a documentação oficial de desenvolvedor da Apple, frameworks, APIs, SwiftUI, UIKit e vídeos da WWDC por meio do Protocolo de Contexto do Modelo. Pesquise documentação de iOS, macOS, watchOS, tvOS e visionOS com consultas em linguagem natural com IA. Obtenha acesso instantâneo a exemplos de código Swift/Objective-C, referências de API e guias técnicos diretamente no Claude, Cursor ou qualquer assistente de IA compatível com MCP.

Inglês | 日本語 | 한국어 | 简体中文

✨ Recursos

• 🔍 Pesquisa Inteligente: Pesquisa inteligente na Documentação de Desenvolvedor Apple para SwiftUI, UIKit, Foundation, CoreData, ARKit e muito mais
• 📚 Acesso Completo à Documentação: Acesso total à API JSON da Apple para documentação de Swift, Objective-C e frameworks
• 🔧 Índice de Frameworks: Navegue por estruturas hierárquicas de API para frameworks de iOS, macOS, watchOS, tvOS e visionOS
• 📋 Catálogo de Tecnologias: Explore tecnologias da Apple, incluindo SwiftUI, UIKit, Metal, Core ML, Vision e ARKit
• 📰 Atualizações de Documentação: Acompanhe anúncios da WWDC 2024/2025, iOS 26, macOS 26 e os lançamentos mais recentes de SDKs
• 🎯 Visões Gerais de Tecnologias: Guias abrangentes para Swift, SwiftUI, UIKit e todas as plataformas de desenvolvimento da Apple
• 💻 Biblioteca de Códigos de Exemplo: Exemplos de código em Swift e Objective-C para desenvolvimento iOS, macOS e multiplataforma
• 🎥 Biblioteca de Vídeos da WWDC: Pesquise sessões da WWDC 2014-2025 com transcrições, exemplos de código Swift/SwiftUI e recursos
• 🔗 Descoberta de APIs Relacionadas: Encontre visualizações SwiftUI, controladores UIKit e relações de API específicas de frameworks
• 📊 Compatibilidade de Plataformas: Análise de compatibilidade para iOS 13+, macOS 10.15+, watchOS 6+, tvOS 13+ e visionOS
• ⚡ Alto Desempenho: Otimizado para Xcode, Swift Playgrounds e ambientes de desenvolvimento com IA
• 🔄 Pool Inteligente de UserAgent: Sistema inteligente de rotação de UserAgent com recuperação automática de falhas e monitoramento de desempenho
• 🌐 Multiplataforma: Suporte completo à documentação de iOS, iPadOS, macOS, watchOS, tvOS e visionOS
• 🏷️ Rastreamento de Beta e Status: APIs beta do iOS 26, métodos UIKit obsoletos, rastreamento de novos recursos do SwiftUI

🚀 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", "@kimsungwhee/apple-docs-mcp"]
    }
  }
}

Observação: Se você encontrar problemas com uma versão antiga em uso, adicione @latest para forçar a versão mais recente:

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

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

📦 Instalação

claude mcp add apple-docs -- npx -y @kimsungwhee/apple-docs-mcp@latest

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

{
  "mcp": {
    "servers": {
      "apple-docs": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@kimsungwhee/apple-docs-mcp"]
      }
    }
  }
}

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

{
  "context_servers": {
    "Apple Docs": {
      "command": {
        "path": "npx",
        "args": ["-y", "@kimsungwhee/apple-docs-mcp"]
      },
      "settings": {}
    }
  }
}

{
  "mcpServers": {
    "apple-docs": {
      "command": "npx",
      "args": ["-y", "@kimsungwhee/apple-docs-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

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

{
  "mcpServers": {
    "apple-docs": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@kimsungwhee/apple-docs-mcp"],
      "disabled": false,
      "autoApprove": []
    }
  }
}

# Using pnpm (recommended)
pnpm add -g @kimsungwhee/apple-docs-mcp

# Using npm
npm install -g @kimsungwhee/apple-docs-mcp

npx @kimsungwhee/apple-docs-mcp --help

git clone https://github.com/kimsungwhee/apple-docs-mcp.git
cd apple-docs-mcp

# Using pnpm (recommended)
pnpm install && pnpm run build

# Using npm
npm install && npm run build

💬 Exemplos de Uso

🔍 Pesquisa Inteligente

"Search for SwiftUI animations"
"Find withAnimation API documentation"
"Look up async/await patterns in Swift"
"Show me UITableView delegate methods"
"Search Core Data NSPersistentContainer examples"
"Find AVFoundation video playback APIs"

📚 Acesso à Documentação

"Get detailed information about the SwiftUI framework"
"Show me withAnimation API with related APIs"
"Get platform compatibility for SwiftData"
"Access UIViewController documentation with similar APIs"
"Show me NSManagedObjectContext documentation"
"Get URLSession async/await methods"

🔧 Exploração de Frameworks

"Show me SwiftUI framework API index"
"List all UIKit classes and methods"
"Browse ARKit framework structure"
"Get WeatherKit API hierarchy"
"Explore Core ML model loading APIs"
"Show Vision framework image analysis APIs"

🔗 Descoberta de APIs

"Find APIs related to UIViewController"
"Show me similar APIs to withAnimation"
"Get all references from SwiftData documentation"
"Discover alternatives to Core Data NSManagedObject"

📋 Análise de Tecnologias e Plataformas

"List all Beta frameworks in iOS 26"
"Show me Graphics & Games technologies"
"What machine learning frameworks are available?"
"Analyze platform compatibility for Vision framework"

📰 Atualizações de Documentação

"Show me the latest WWDC updates"
"What's new in SwiftUI?"
"Get technology updates for iOS"
"Show me release notes for Xcode"
"Find beta features in the latest updates"

🎯 Visões Gerais de Tecnologias

"Show me technology overviews for app design and UI"
"Get comprehensive guides for games development"
"Explore AI and machine learning overviews"
"Show me iOS-specific technology guides"
"Get data management technology overviews"

💻 Biblioteca de Códigos de Exemplo

"Show SwiftUI sample code projects"
"Find sample code for machine learning"
"Get UIKit example projects"
"Show featured WWDC sample code"
"Find Core Data sample implementations"
"Show only beta sample code projects"

🎥 Pesquisa de Vídeos da WWDC

"Search WWDC videos about SwiftUI"
"Find WWDC sessions on machine learning"
"Show me WWDC 2024 videos"
"Search for async/await WWDC talks"
"Find WWDC videos about Swift concurrency"
"Show accessibility-focused WWDC sessions"

📺 Detalhes de Vídeos da WWDC

"Get details for WWDC session 10176"
"Show me the transcript for WWDC23 session on SwiftData"
"Get code examples from WWDC video 10019"
"Show resources from Vision Pro WWDC session"
"Get transcript for 'Meet async/await in Swift' session"

📋 Tópicos e Anos da WWDC

"List all WWDC topics"
"Show me Swift topic WWDC videos"
"Get WWDC videos about developer tools"
"List WWDC videos from 2023"
"Show all SwiftUI and UI frameworks sessions"
"Get machine learning WWDC content"

🛠️ Uso Avançado

"Find related APIs for @State with platform analysis"
"Resolve all references from SwiftUI documentation"
"Get platform compatibility analysis for Vision framework"
"Find similar APIs to UIViewController with deep search"

🛠️ Ferramentas Disponíveis

🏗️ Arquitetura Técnica para Acesso à Documentação de Desenvolvedor Apple

apple-docs-mcp/
├── 🔧 src/
│   ├── index.ts                      # MCP server entry point with all tools
│   ├── tools/                        # MCP tool implementations
│   │   ├── search-parser.ts          # HTML search result parsing
│   │   ├── doc-fetcher.ts            # JSON API documentation fetching
│   │   ├── list-technologies.ts      # Technology catalog handling
│   │   ├── get-documentation-updates.ts # Documentation updates tracking
│   │   ├── get-technology-overviews.ts # Technology overviews and guides
│   │   ├── get-sample-code.ts        # Sample code library browser
│   │   ├── get-framework-index.ts    # Framework structure indexing
│   │   ├── get-related-apis.ts       # Related API discovery
│   │   ├── resolve-references-batch.ts # Batch reference resolution
│   │   ├── get-platform-compatibility.ts # Platform analysis
│   │   ├── find-similar-apis.ts      # Similar API recommendations
│   │   └── wwdc/                     # WWDC video tools
│   │       ├── wwdc-handlers.ts      # WWDC tool handlers
│   │       ├── content-extractor.ts  # Video content extraction
│   │       ├── topics-extractor.ts   # Topic listing
│   │       └── video-list-extractor.ts # Video list parsing
│   └── utils/                        # Utility functions and helpers
│       ├── cache.ts                  # Memory cache with TTL support
│       ├── constants.ts              # Application constants and URLs
│       ├── error-handler.ts          # Error handling and validation
│       ├── http-client.ts            # HTTP client with performance tracking
│       ├── user-agent-pool.ts        # Smart UserAgent rotation system
│       ├── http-headers-generator.ts # Dynamic browser headers generation
│       └── url-converter.ts          # URL conversion utilities
├── 📦 dist/                          # Compiled JavaScript
├── 📄 package.json                   # Package configuration
└── 📖 README.md                      # This file

🚀 Recursos de Desempenho

• Cache Baseado em Memória: Implementação de cache personalizada com limpeza automática e suporte a TTL
• Pool Inteligente de UserAgent: Sistema inteligente de rotação com recuperação automática de falhas e monitoramento de desempenho
• Cabeçalhos Dinâmicos: Geração de cabeçalhos de navegador realistas (Accept, Accept-Language, User-Agent)
• Pesquisa Inteligente: API de pesquisa oficial da Apple com formatação aprimorada de resultados
• Análise Aprimorada: APIs relacionadas opcionais, compatibilidade de plataformas e análise de similaridade
• Resiliência a Erros: Degradação graciosa com tratamento abrangente de erros
• Segurança de Tipos: TypeScript completo com validação em tempo de execução Zod v4.0.5
• Dependências Mais Recentes: MCP SDK v1.15.1, footprint otimizado do pacote

💾 Estratégia de Cache

📦 Dados da WWDC

Todos os dados de vídeo da WWDC (2014-2025) estão incluídos diretamente no pacote npm, fornecendo:

• ✅ Zero latência de rede - Nenhuma chamada de API necessária para conteúdo da WWDC
• ✅ Acesso 100% offline - Funciona sem conexão com a internet
• ✅ Sem limites de taxa - Pesquisas e navegação ilimitadas na WWDC
• ✅ Respostas instantâneas - Todos os dados estão disponíveis localmente

O pacote inclui:

• 📹 Mais de 1.260 vídeos de sessões da WWDC com transcrições completas
• 🏷️ 20 categorias de tópicos para navegação organizada
• 📅 13 anos de conteúdo (2012-2025)
• 💾 35MB de dados JSON otimizados

Observação: Mantenha seu pacote atualizado para obter as adições mais recentes de conteúdo da WWDC.

⚙️ Configuração

🔄 Configuração do Pool de UserAgent

O servidor MCP inclui um sistema inteligente de rotação de UserAgent para melhorar a confiabilidade da API:

Variáveis de Ambiente

Configuração Personalizada do Pool

# Configure custom UserAgent pool
export USER_AGENT_POOL_CONFIG='[
  {"userAgent": "MyApp/1.0 (compatible)", "weight": 3, "maxUsageCount": 1000},
  {"userAgent": "MyApp/2.0 (advanced)", "weight": 2, "maxUsageCount": 800}
]'

# Set rotation strategy (random/sequential/smart)
export USER_AGENT_POOL_STRATEGY=smart

# Enable debugging
export NODE_ENV=development

Estratégias Disponíveis

• random: Seleção aleatória rápida (melhor desempenho)
• sequential: Rotação round-robin (ordem previsível)
• smart: Otimização da taxa de sucesso (melhor confiabilidade)

UserAgents Integrados

O servidor inclui mais de 12 strings de UserAgent pré-configuradas cobrindo:

• Chrome (Mac Intel/Apple Silicon, Windows, Linux)
• Firefox (Mac Intel/Apple Silicon, Windows, Linux)
• Safari (Mac Intel/Apple Silicon, versões mais recentes)
• Edge (Windows, Mac Intel/Apple Silicon)

🧪 Desenvolvimento

Comandos Rápidos

# Development with auto-reload
pnpm run dev    # or: npm run dev

# Build for production  
pnpm run build  # or: npm run build

# Type checking
pnpm exec tsc --noEmit  # or: npx tsc --noEmit

# Clean build artifacts
pnpm run clean  # or: npm run clean

Testando Localmente

# Test the MCP server directly
node dist/index.js

# Test with sample queries
npx @kimsungwhee/apple-docs-mcp --test

🤝 Contribuindo

Contribuições são bem-vindas! Veja como começar:

1. Faça um fork do repositório
2. Crie um branch de recurso: 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 - consulte LICENSE para detalhes.

⚠️ Aviso Legal

Este projeto não é afiliado ou endossado pela Apple Inc. Ele usa APIs publicamente disponíveis da Documentação de Desenvolvedor Apple para fins educacionais e de desenvolvimento.