Apple Docs 2.0 MCP

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

Apple Docs 2.0 MCP

Un solo MCP para la documentación de desarrollo de Apple, las guías de diseño y las sesiones de WWDC.

¿Estás creando tu próxima app para iOS con un agente? Deja que lea primero los documentos propios de Apple: menos reescrituras, menos interrupciones.

Inicio rápido · Novedades · Instalación · Uso · Herramientas · Arquitectura · Desarrollo

npx -y apple-docs-2.0-mcp

Documentación de desarrollo de Apple para asistentes de IA, a través del Model Context Protocol: referencia de API, artículos, código de ejemplo, tutoriales, las Guías de Interfaz Humana, Ayuda de App Store Connect, las API de servicios web (App Store Connect API, App Store Server API y otras) y 1.700 sesiones de WWDC con sus transcripciones y código, en Claude, Cursor, VS Code o cualquier cliente MCP.

Apple Docs 2.0 MCP es una bifurcación de Apple Docs MCP de kimsungwhee, mejorado con adiciones, correcciones y una nueva herramienta.

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

Nota: Si encuentras problemas con una versión antigua en uso, añade @latest para forzar la última versión:

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

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

Claude Code

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

Pregunta a tu agente

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

🆕 Novedades en 2.0

Apple Docs 2.0 MCP conserva todas las herramientas de Apple Docs MCP 1.0.26 y corrige lo que dejó de funcionar o volvía incompleto, para que tu asistente responda desde la documentación propia de Apple en lugar de adivinar.

🔍 Búsqueda que devuelve resultados

search_apple_docs está corregido: ahora usa el mismo servicio de búsqueda que usa el sitio web de Apple, así tu asistente obtiene los resultados que verías en developer.apple.com: referencia de API, artículos, código de ejemplo, guías de diseño, Ayuda de App Store Connect y vídeos de WWDC. En el original, las búsquedas vuelven vacías desde que Apple cambió su página de búsqueda.

Pregunta sobre una API, una guía de diseño o un proceso de App Store, y el asistente primero busca y luego lee las páginas que encuentra.

🗺️ Consulta cualquier página por nombre

Una nueva herramienta, search_docs_map, encuentra cualquiera de las 336.629 páginas por nombre, o parte de uno, sin conexión:

• Símbolos de API: tipos, métodos, propiedades, casos de enum, macros
• Artículos, tutoriales y código de ejemplo
• Claves de Info.plist y entitlements
• Endpoints de servicios web, como los de App Store Connect API
• Páginas de Guías de Interfaz Humana y Ayuda de App Store Connect

Úsala cuando ya conozcas un nombre, desde código o un mensaje de error, para abrir su página directamente.

📄 Páginas de documentación completas

Las páginas llegan completas, como en el sitio de Apple: cada método y propiedad con su firma completa (var view: UIView!, no solo view), lo que un tipo hereda y a lo que se ajusta, APIs relacionadas y las versiones de SO que lo soportan. 2.0 también lee las Guías de Interfaz Humana, tutoriales, Ayuda de App Store Connect y endpoints de App Store Connect API con sus parámetros y respuestas.

Pregunta sobre cualquier API, guía o tema de App Store Connect, y el asistente lee la página completa antes de responder o escribir código.

🎥 WWDC 2014–2026, con código

1.700 sesiones están integradas, incluyendo WWDC26, y funcionan sin conexión: transcripciones para 1.416 de ellas y ejemplos de código para 715, cada ejemplo con el momento en que aparece en el vídeo. Las sesiones están clasificadas bajo los mismos temas que en el sitio web de Apple.

Pregunta cómo funciona una nueva API, y el asistente puede citar la sesión de WWDC que la presentó, con su código.

📋 Listas de frameworks completas

La lista de tecnologías del original se detenía después de 200 entradas, por lo que categorías enteras (Graphics and Games, Media, System, Web) nunca aparecían, y su búsqueda de símbolos mezclaba encabezados con enlaces rotos. 2.0 lista todo, marca los frameworks en beta y encuentra frameworks por tema: "Machine learning" devuelve Core ML, Create ML, Foundation Models, Vision y más.

Pregunta qué frameworks se ajustan a una tarea, como machine learning o audio, y el asistente compara la lista completa.

🛠️ Diseñado para seguir funcionando

Dependencias actualizadas, solicitudes que parecen de un navegador normal y esperan su turno (Apple devuelve búsquedas vacías cuando llegan demasiado rápido), reintentos automáticos cuando una solicitud falla y 255 pruebas automatizadas. Los 63 ejemplos de uso del README original se ejecutan sin errores.

Nada que configurar: sin clave de API ni cuenta.

✨ Características

• 🔍 Búsqueda: documentación de Apple, guías de diseño, código de ejemplo, Ayuda de App Store Connect y sesiones de WWDC en una sola búsqueda, o solo una de ellas
• 🗺️ Mapa de documentación: encuentra cualquier página por su título, incluso un método o nombre de propiedad, sin solicitud de red
• 📚 Páginas de documentación: APIs de Swift y Objective-C, artículos, tutoriales y referencias de servicios web como Markdown
• 🎨 Guías de Interfaz Humana: cada página de HIG, buscable y legible
• 🏪 Ayuda de App Store Connect: campos de página de producto, revisión, TestFlight, precios
• 🔧 Símbolos de frameworks: explora las clases, structs, protocolos y miembros de un framework por comodín
• 🔗 Relaciones de API: APIs relacionadas, similares y referenciadas, y reemplazos para las obsoletas
• 📊 Compatibilidad de plataformas: la versión que introdujo y dejó obsoleta una API en cada plataforma
• 📋 Catálogo de tecnologías: cada framework y tecnología de Apple por categoría, con los beta marcados
• 📰 Actualizaciones de documentación: notas de versión, actualizaciones de frameworks y páginas de "Novedades" de WWDC
• 🎯 Resúmenes de tecnologías: guías de Apple sobre diseño de apps, juegos, IA y machine learning, datos y más
• 💻 Código de ejemplo: proyectos de ejemplo de Apple con sus resúmenes y enlaces de descarga
• 🎥 Biblioteca de WWDC: 1.700 sesiones de 2014 a 2026 con transcripciones, ejemplos de código con tiempo, recursos y sesiones relacionadas, sin conexión

📦 Instalación

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": {}
    }
  }
}

💬 Ejemplos de uso

🔍 Búsqueda

"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 documentación

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

📚 Acceso a documentación

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

🔧 Exploración de frameworks

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

🔗 Descubrimiento de API

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

📋 Tecnologías, actualizaciones y resúmenes

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

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

🛠️ Herramientas disponibles

Las herramientas de documentación obtienen developer.apple.com; las herramientas de WWDC leen los datos incluidos y search_docs_map lee el mapa de documentación, ambos sin solicitud de red.

🏗️ Arquitectura

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

🌐 Solicitudes y caché

Cada solicitud pasa por un cliente HTTP: fetch con los encabezados de Safari, como máximo 100 solicitudes por minuto, y búsquedas una a la vez, con 15 segundos de diferencia, ya que Apple responde a las más rápidas sin resultados. Cada intento tiene un tiempo de espera de 2 minutos, con hasta 3 reintentos y retroceso en errores de red, tiempos de espera y respuestas 5xx.

📦 Datos de WWDC

Las sesiones de WWDC están incluidas en data/wwdc/, por lo que las herramientas de WWDC funcionan sin conexión y sin límites de velocidad:

• 📹 1.700 sesiones de 2014 a 2026, 1.416 con transcripciones y 715 con ejemplos de código
• 🏷️ 19 temas, tomados de las páginas de temas de Apple
• 💾 41 MB de JSON

npx tsx scripts/add-wwdc-year.ts <year> añade un año, o lo actualiza, desde las páginas de Apple; una sesión que Apple ya no lista conserva sus datos almacenados.

🗺️ Mapa de documentación

api-map/apple-docs-map.tsv lista 336.629 páginas (URL, título, tipo, tecnología, grupo y árbol) de los índices de navegación de Apple, las Guías de Interfaz Humana y la navegación de Ayuda de App Store Connect. search_docs_map lo lee en cada llamada. npx tsx scripts/build-docs-map.ts api-map/apple-docs-map.tsv lo reconstruye en unos 10 minutos.

🧪 Desarrollo

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)

Después de una compilación, reinicia o reconecta el servidor en tu cliente MCP.

🙏 Créditos

Apple Docs 2.0 MCP se basa en Apple Docs MCP de kimsungwhee, cuyas herramientas, datos de WWDC y estructura sirvieron como punto de partida.

🤝 Contribuciones

Las contribuciones son bienvenidas:

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

📄 Licencia

Licencia MIT, como el proyecto original: consulta LICENSE.

⚠️ Aviso legal

Este proyecto no está afiliado ni respaldado por Apple Inc. Lee la documentación para desarrolladores disponible públicamente de Apple con fines educativos y de desarrollo.