cupertino MCP — Casos de uso, Instalar & Demo en vivo

Por qué usarlo

Características clave

Completamente local — funciona sin conexión, sin dependencias de APIs de Apple
Búsqueda de texto completo con clasificación BM25, menores a 100ms
Búsqueda HIG separada por plataforma, independiente de documentación de referencia
Índice de proyectos de ejemplo de Apple: búsqueda + lectura de archivos fuente

Demo en vivo

Cómo se ve en la práctica

cupertino.replay ▶ listo

0/0

Instalar

Elige tu cliente

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

{
  "mcpServers": {
    "cupertino": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/mihaelamj/cupertino"
      ],
      "_inferred": true
    }
  }
}

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

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

{
  "mcpServers": {
    "cupertino": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/mihaelamj/cupertino"
      ],
      "_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": {
    "cupertino": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/mihaelamj/cupertino"
      ],
      "_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": {
    "cupertino": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/mihaelamj/cupertino"
      ],
      "_inferred": true
    }
  }
}

Mismo formato que Claude Desktop. Reinicia Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "cupertino",
      "command": "TODO",
      "args": [
        "See README: https://github.com/mihaelamj/cupertino"
      ]
    }
  ]
}

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

~/.config/zed/settings.json

{
  "context_servers": {
    "cupertino": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/mihaelamj/cupertino"
        ]
      }
    }
  }
}

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

claude mcp add cupertino -- TODO 'See README: https://github.com/mihaelamj/cupertino'

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

Casos de uso

Usos del mundo real: cupertino

Detén alucinaciones de API con cupertino para documentación de Apple

👤 Desarrolladores de iOS / macOS / visionOS ⏱ ~10 min beginner

Cuándo usarlo: Claude sigue inventando firmas de API; quieres que esté basado en documentación real.

Requisitos previos

cupertino instalado — Descarga el binario de Swift 6.2+; ejecuta cupertino setup para descargar el índice

Flujo

Configura el índice

Ejecuta cupertino setup y luego cupertino serve. Confirma que el servidor MCP está escuchando.✓ Copiado

→ Servidor en línea
Obliga al agente a citar

Antes de escribir código SwiftUI, busca en los documentos de cupertino la API exacta. Cita la firma.✓ Copiado

→ API verificada con URI
Úsalo

Ahora escribe el código usando solo las APIs que citaste.✓ Copiado

→ Se compila al primer intento

Resultado: Significativamente menos alucinaciones de API.

Revisa un diseño contra las Pautas de Interfaz Humana de Apple

👤 Diseñadores de iOS, gerentes de producto ⏱ ~20 min intermediate

Cuándo usarlo: Antes de enviar, quieres verificar un flujo contra HIG.

Flujo

Describe la pantalla

Estoy construyendo una pantalla de configuración con un botón destructivo 'Eliminar cuenta'. Usa search_hig para iOS para encontrar orientación relevante.✓ Copiado

→ Pasajes HIG sobre acciones destructivas
Aplica

Dadas esas pautas, critica mi mockup [pega]. ¿Qué viola HIG?✓ Copiado

→ Violaciones específicas + correcciones

Resultado: IU conforme a HIG sin leer todo el documento tú mismo.

Combinar con: claude-talk-to-figma

Aprende de los proyectos de ejemplo de Apple a través de cupertino

👤 Desarrolladores que aprenden nuevos frameworks ⏱ ~15 min beginner

Cuándo usarlo: Necesitas saber 'cómo Apple realmente usa esta API'.

Flujo

Encuentra muestras relevantes

search_samples para 'relaciones SwiftData'. Lista proyectos coincidentes.✓ Copiado

→ Nombres de proyectos + descripciones
Lee la fuente

En el proyecto X, lee ContentView.swift y explica la configuración de relaciones.✓ Copiado

→ Recorrido anotado

Resultado: Patrones reales respaldados por Apple en lugar de conjeturas de foros.

Combinaciones

Combínalo con otros MCPs para multiplicar por 10

cupertino + claude-talk-to-figma

Diseña en Figma, valida contra HIG a través de cupertino

Para la pantalla de Figma seleccionada, busca HIG para reglas relevantes e identifica inconsistencias.✓ Copiado

cupertino + filesystem

Compara tu código SwiftUI contra el ejemplo de Apple para el mismo patrón

Lee mi ./Sources/ContentView.swift y contrasta contra la estructura de ejemplo SwiftData de Apple.✓ Copiado

Herramientas

Lo que expone este MCP

Herramienta	Entradas	Cuándo llamar
search_docs	query, framework?	Búsqueda de referencia de API
search_hig	query, platform?	Orientación de diseño
list_frameworks		Descubre qué está indexado
read_document	uri	Amplía un resultado de búsqueda
search_samples	query	Descubrimiento de código de ejemplo
list_samples		Examina
read_sample_file	sample, path	Lee un archivo específico

Coste y límites

Lo que cuesta ejecutarlo

Cuota de API: Ninguno — FTS5 local
Tokens por llamada: Páginas de documentación: 500-5000 cada una
Monetario: Gratis
Consejo: Usa search_docs + read_document solo en el resultado principal en lugar de descargar varias páginas

Seguridad

Permisos, secretos, alcance

Almacenamiento de credenciales: Ninguno

Salida de datos: Ninguno en tiempo de ejecución; cupertino setup obtiene de developer.apple.com una sola vez

Resolución de problemas

Errores comunes y soluciones

La búsqueda no devuelve nada después de la instalación

cupertino setup no se completó — ejecuta de nuevo y observa errores de red

Verificar: El tamaño del archivo de base de datos debe ser ~2.4GB

Documentación obsoleta después de un lanzamiento del SO

Ejecuta de nuevo cupertino setup para actualizar el rastreo

Base de datos de índice demasiado grande para la máquina

Usa la configuración con alcance de framework para indexar solo lo que necesitas (p.ej. solo SwiftUI)

Alternativas

cupertino vs otros

Alternativa	Cuándo usarla	Contrapartida
DuckDuckGo / web search MCP	No te importa el riesgo de alucinación y necesitas lo más reciente	No es oficial; puede devolver blogs de terceros
Apple Developer website directly	Lectura dirigida por humanos	Sin automatización de agente

Más

Recursos

📖 Lee el README oficial en GitHub

🐙 Ver issues abiertas

🔍 Ver todos los 400+ servidores MCP y Skills