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

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

Por qué usarlo

Características clave

Busca en documentación de Apple: SwiftUI, UIKit, Foundation, ARKit, Core ML, Metal, Vision
Búsqueda de videos WWDC 2014-2025 con transcripciones y ejemplos de código
Búsqueda de símbolos con alcance de framework
Compatibilidad de plataforma + seguimiento de APIs deprecadas
Índice de sesiones WWDC empaquetado sin conexión

Demo en vivo

Cómo se ve en la práctica

apple-docs.replay ▶ listo

0/0

Instalar

Elige tu 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
    }
  }
}

Abre Claude Desktop → Settings → Developer → Edit Config. Reinicia después de guardar.

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

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

Cursor usa el mismo esquema mcpServers que Claude Desktop. La configuración del proyecto prevalece sobre la global.

VS Code → Cline → MCP Servers → Edit

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

Haz clic en el icono MCP Servers de la barra lateral de Cline y luego en "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

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

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

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

Continue usa un array de objetos de servidor en lugar de un mapa.

~/.config/zed/settings.json

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

Añádelo a context_servers. Zed recarga en caliente al guardar.

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

Un solo comando. Verifica con claude mcp list. Quita con claude mcp remove.

Casos de uso

Usos del mundo real: apple-docs-mcp

Cómo evitar que tu agente alucine con APIs de SwiftUI

👤 Desarrolladores iOS que usan Claude/Cursor ⏱ ~10 min beginner

Cuándo usarlo: El agente sugiere APIs que no existen en la versión de iOS que es tu objetivo.

Requisitos previos

Node 18+ — nvm install 20

Flujo

Instala

Instala vía: npx -y @kimsungwhee/apple-docs-mcp@latest (o agrega a la configuración MCP).✓ Copiado

→ Aparecen las herramientas
Fundamenta tu pregunta

Usa search_apple_docs para encontrar 'navigationDestination' y get_platform_compatibility para verificar que esté disponible en iOS 16+.✓ Copiado

→ Entrada de documentación oficial + versión mínima de deployment
Cita en el código

Ahora escribe el código de navegación citando la documentación que acabas de leer.✓ Copiado

→ Código + citas

Resultado: Código que compila contra tu objetivo de deployment.

Errores comunes

Se muestran APIs solo de WWDC antes del lanzamiento — Verifica get_platform_compatibility — las APIs beta están marcadas

Combinar con: github

Cómo encontrar la sesión de WWDC que explica una característica

👤 Desarrolladores iOS que adoptan nuevas características ⏱ ~10 min beginner

Cuándo usarlo: La documentación es breve; el contexto está en una charla de WWDC que no viste.

Flujo

Busca en WWDC

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

→ Lista de sesiones
Extrae transcripción + código

get_wwdc_video_details para el resultado superior. Extrae los ejemplos de código.✓ Copiado

→ Transcripción + fragmentos de código

Resultado: Contexto + código funcionando sin ver el video.

Cómo planificar una migración desde una API deprecada

👤 Desarrolladores iOS que mantienen codebases antiguas ⏱ ~10 min intermediate

Cuándo usarlo: Una advertencia dice 'deprecada en iOS 17' y quieres el reemplazo.

Flujo

Confirma la deprecación

get_platform_compatibility para UIActivityIndicatorView.startAnimating.✓ Copiado

→ Línea de tiempo de disponibilidad
Encuentra el reemplazo recomendado

find_similar_apis — ¿cuál es el equivalente en SwiftUI?✓ Copiado

→ ProgressView() con argumentos apropiados

Resultado: Plan de migración confiado con referencias.

Combinar con: github

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

apple-docs + github

Fundamenta un PR de migración con referencias de documentación + sesiones WWDC

Encuentra el reemplazo de SwiftUI para nuestro uso de UIKit ActivityViewController, cita la documentación de Apple y sesiones WWDC, y redacta un PR de migración.✓ Copiado

apple-docs + filesystem

Escanea código local para APIs deprecadas y sugiere reemplazos

Busca en mi Sources/ cualquier API marcada como deprecada según apple-docs-mcp; produce una lista de verificación de migración.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar	Coste
search_apple_docs	query: str, platform?: str	Encuentra cualquier API por nombre o tema	Gratis
get_apple_doc_content	url_or_id	Lee la página completa después de buscar	Gratis
list_technologies	category?, include_beta?: bool	Explora frameworks	Gratis
search_framework_symbols	framework, query	Búsqueda de símbolos con alcance	Gratis
get_related_apis	symbol	Recorrido de herencia/conformidad	Gratis
get_platform_compatibility	symbol	Verifica disponibilidad	Gratis
find_similar_apis	symbol	Reemplazos para APIs deprecadas	Gratis
get_sample_code	topic?	Encuentra proyectos de ejemplo de Apple	Gratis
search_wwdc_videos	query, years?: int[], topics?: str[]	Encuentra charlas WWDC	Gratis
get_wwdc_video_details	session_id	Contexto completo de la sesión	Gratis

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: developer.apple.com tiene límites de velocidad de uso razonable; la herramienta cachea para reducir llamadas
Tokens por llamada: Documentación: 500-3000 tokens. Transcripciones: hasta 20k tokens para sesiones largas
Monetario: Gratis
Consejo: Usa search_framework_symbols en lugar de search_apple_docs amplio para ahorrar tokens.

Seguridad

Permisos, secretos, alcance

Ámbitos mínimos: Ninguno — solo documentación pública

Almacenamiento de credenciales: Ninguno

Salida de datos: developer.apple.com + índice offline empaquetado

No conceder nunca: Nada que otorgar

La documentación de Apple se revisa sin notificación; las respuestas de Claude pueden atrasarse unos días respecto al sitio en vivo.

Resolución de problemas

Errores comunes y soluciones

La búsqueda no devuelve resultados

La consulta puede ser demasiado específica — intenta solo el nombre de la clase o usa list_technologies para explorar.

El contenido de la documentación parece truncado

Algunas páginas son grandes; la herramienta trunca — pasa la URL a get_apple_doc_content que maneja la paginación.

Video WWDC no encontrado

Algunas sesiones antiguas no tienen transcripción. Usa search_wwdc_videos con filtro de años.

Alternativas

apple-docs-mcp vs otros

Alternativa	Cuándo usarla	Contrapartida
apple-docs vía firecrawl	Quieres scraping en bruto	Sin índice WWDC, sin estructura
context7 MCP	Quieres documentación de bibliotecas generales, no específica de Apple	Cobertura más débil de Apple

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills