Apple Developer Documentation

Apple Docs MCP - Servidor de Protocolo de Contexto de Modelo para Documentación de Apple Developer

Servidor MCP de Documentación de Apple Developer: accede a la documentación oficial de Apple, frameworks, APIs, SwiftUI, UIKit y videos de WWDC a través del Protocolo de Contexto de Modelo. Busca documentación de iOS, macOS, watchOS, tvOS y visionOS con consultas en lenguaje natural impulsadas por IA. Obtén acceso instantáneo a ejemplos de código Swift/Objective-C, referencias de API y guías técnicas directamente en Claude, Cursor o cualquier asistente de IA compatible con MCP.

Español | 日本語 | 한국어 | 简体中文

✨ Características

• 🔍 Búsqueda Inteligente: Búsqueda inteligente en la Documentación de Apple Developer para SwiftUI, UIKit, Foundation, CoreData, ARKit y más
• 📚 Acceso Completo a Documentación: Acceso completo a la API JSON de Apple para documentación de Swift, Objective-C y frameworks
• 🔧 Índice de Frameworks: Explora estructuras jerárquicas de API para frameworks de iOS, macOS, watchOS, tvOS y visionOS
• 📋 Catálogo de Tecnologías: Explora tecnologías de Apple, incluyendo SwiftUI, UIKit, Metal, Core ML, Vision y ARKit
• 📰 Actualizaciones de Documentación: Sigue los anuncios de WWDC 2024/2025, iOS 26, macOS 26 y los últimos lanzamientos de SDK
• 🎯 Resúmenes de Tecnología: Guías completas para Swift, SwiftUI, UIKit y todas las plataformas de desarrollo de Apple
• 💻 Biblioteca de Código de Ejemplo: Ejemplos de código en Swift y Objective-C para desarrollo en iOS, macOS y multiplataforma
• 🎥 Biblioteca de Videos WWDC: Busca sesiones de WWDC 2014-2025 con transcripciones, ejemplos de código Swift/SwiftUI y recursos
• 🔗 Descubrimiento de APIs Relacionadas: Encuentra vistas de SwiftUI, controladores de UIKit y relaciones de API específicas de frameworks
• 📊 Compatibilidad de Plataformas: Análisis de compatibilidad para iOS 13+, macOS 10.15+, watchOS 6+, tvOS 13+ y visionOS
• ⚡ Alto Rendimiento: Optimizado para Xcode, Swift Playgrounds y entornos de desarrollo impulsados por IA
• 🔄 Pool Inteligente de UserAgent: Sistema inteligente de rotación de UserAgent con recuperación automática de fallos y monitoreo de rendimiento
• 🌐 Multiplataforma: Soporte completo de documentación para iOS, iPadOS, macOS, watchOS, tvOS y visionOS
• 🏷️ Seguimiento de Beta y Estado: APIs beta de iOS 26, métodos obsoletos de UIKit, seguimiento de nuevas funciones de SwiftUI

🚀 Inicio Rápido

Claude Desktop (Recomendado)

Añade esto a tu configuración de 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"]
    }
  }
}

Nota: Si encuentras problemas con una versión antigua en uso, añade @latest para forzar la versión más reciente:

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

Reinicia Claude Desktop y ¡empieza a preguntar sobre las APIs de Apple!

📦 Instalación

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

💬 Ejemplos de Uso

🔍 Búsqueda 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"

📚 Acceso a Documentación

"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"

🔧 Exploración 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"

🔗 Descubrimiento 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álisis de Tecnología y 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"

📰 Actualizaciones de Documentación

"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"

🎯 Resúmenes de Tecnología

"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ódigo de Ejemplo

"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"

🎥 Búsqueda de Videos 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"

📺 Detalles de Videos 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"

📋 Temas y Años de 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 Avanzado

"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"

🛠️ Herramientas Disponibles

🏗️ Arquitectura Técnica para el Acceso a la Documentación de Apple Developer

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

🚀 Características de Rendimiento

• Caché Basada en Memoria: Implementación de caché personalizada con limpieza automática y soporte de TTL
• Pool Inteligente de UserAgent: Sistema de rotación inteligente con recuperación automática de fallos y monitoreo de rendimiento
• Cabeceras Dinámicas: Generación de cabeceras de navegador realistas (Accept, Accept-Language, User-Agent)
• Búsqueda Inteligente: API de búsqueda oficial de Apple con formato de resultados mejorado
• Análisis Mejorado: APIs relacionadas opcionales, compatibilidad de plataformas y análisis de similitud
• Resiliencia ante Errores: Degradación gradual con manejo integral de errores
• Seguridad de Tipos: TypeScript completo con validación en tiempo de ejecución de Zod v4.0.5
• Dependencias Actualizadas: MCP SDK v1.15.1, huella de paquete optimizada

💾 Estrategia de Caché

📦 Datos de WWDC

Todos los datos de videos WWDC (2014-2025) están incluidos directamente en el paquete npm, lo que proporciona:

• ✅ Cero latencia de red - No se necesitan llamadas a API para contenido WWDC
• ✅ Acceso 100% sin conexión - Funciona sin conexión a internet
• ✅ Sin límites de tasa - Búsquedas y navegación WWDC ilimitadas
• ✅ Respuestas instantáneas - Todos los datos están disponibles localmente

El paquete incluye:

• 📹 Más de 1,260 videos de sesiones WWDC con transcripciones completas
• 🏷️ 20 categorías de temas para navegación organizada
• 📅 13 años de contenido (2012-2025)
• 💾 35MB de datos JSON optimizados

Nota: Mantén tu paquete actualizado para obtener las últimas adiciones de contenido WWDC.

⚙️ Configuración

🔄 Configuración del Pool de UserAgent

El servidor MCP incluye un sistema inteligente de rotación de UserAgent para mejorar la fiabilidad de la API:

Variables de Entorno

Configuración Personalizada del 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

Estrategias Disponibles

• random: Selección aleatoria rápida (mejor rendimiento)
• sequential: Rotación round-robin (orden predecible)
• smart: Optimización de tasa de éxito (mejor fiabilidad)

UserAgents Integrados

El servidor incluye más de 12 cadenas de UserAgent preconfiguradas que cubren:

• Chrome (Mac Intel/Apple Silicon, Windows, Linux)
• Firefox (Mac Intel/Apple Silicon, Windows, Linux)
• Safari (Mac Intel/Apple Silicon, versiones más recientes)
• Edge (Windows, Mac Intel/Apple Silicon)

🧪 Desarrollo

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

Pruebas Locales

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

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

🤝 Contribuciones

¡Las contribuciones son bienvenidas! Así es como empezar:

1. Haz un fork del repositorio
2. Crea una rama de funcionalidad: git checkout -b feature/amazing-feature
3. Haz commit de tus cambios: git commit -m 'Add amazing feature'
4. Haz push a la rama: git push origin feature/amazing-feature
5. Abre una Pull Request

📄 Licencia

Licencia MIT: consulta LICENSE para más detalles.

⚠️ Aviso Legal

Este proyecto no está afiliado ni respaldado por Apple Inc. Utiliza las APIs públicas de Documentación de Apple Developer con fines educativos y de desarrollo.