Apple HIG

Proporciona acceso instantáneo a las Guías de Interfaz Humana de Apple, con contenido actualizado automáticamente de forma periódica.

GitHub
21

Documentación

Apple Dev MCP Icon

🍎 Apple Dev MCP Server

Health Check npm version License: MIT Node.js

Guía completa de desarrollo de Apple para asistentes de IA

Combina las Guías de Interfaz Humana (diseño) con la Documentación Técnica (referencia de API) para todas las plataformas de Apple.

✨ Características

  • 🎨 Cobertura Completa: Directrices de diseño de HIG + documentación de API de Apple para iOS, macOS, watchOS, tvOS, visionOS
  • ⚡ Caché Inteligente: Respuestas rápidas mediante caché inteligente con degradación elegante
  • 🔍 Búsqueda Inteligente: Búsqueda unificada en contenido de diseño y técnico
  • 🤖 Búsqueda Mejorada: Búsqueda avanzada que combina principios de diseño con implementación técnica
  • 📚 Contenido Preconstruido: Más de 113 secciones de Apple HIG preprocesadas para acceso instantáneo

🚀 Inicio Rápido

Opción 1: Extensión de Claude Desktop (Recomendada)

  1. Descargar apple-dev-mcp.dxt desde releases
  2. Doble clic para instalar en Claude Desktop
  3. Reiniciar Claude Desktop
  4. ¡Empieza a usar la guía de desarrollo de Apple!

Opción 2: Instalación Tradicional

npm install -g apple-dev-mcp

🔧 Configuración

Claude Desktop

Añadir a claude_desktop_config.json:

{
  "mcpServers": {
    "Apple Dev": {
      "command": "node",
      "args": ["/usr/local/lib/node_modules/apple-dev-mcp/dist/server.js"]
    }
  }
}
Claude Code 
claude mcp add "Apple-Dev" node /usr/local/lib/node_modules/apple-dev-mcp/dist/server.js
Cursor / Windsurf / VS Code

Crear .cursor/mcp.json, configuración de windsurf, o .vscode/mcp.json:

{
  "mcpServers": {
    "Apple Dev": {
      "command": "node", 
      "args": ["/usr/local/lib/node_modules/apple-dev-mcp/dist/server.js"]
    }
  }
}

Encuentra tu ruta: npm list -g apple-dev-mcp
Usuarios de Windows: Reemplaza con C:\Users\YourUsername\AppData\Roaming\npm\node_modules\apple-dev-mcp\dist\server.js

📖 Uso

Herramientas Disponibles (3 herramientas principales)

Búsqueda de Directrices de Diseño

  • search_human_interface_guidelines - Buscar en Apple HIG con filtros de plataforma
    • Devuelve contenido completo (no fragmentos) para respuestas aptas para IA
    • Cubre todas las plataformas de Apple: iOS, macOS, watchOS, tvOS, visionOS

Búsqueda de Documentación Técnica

  • search_technical_documentation - Buscar documentación de API de Apple
    • Búsquedas específicas por framework (SwiftUI, UIKit, AppKit, etc.)
    • Consultas de símbolos y métodos con ejemplos de código

Búsqueda Unificada

  • search_unified - Búsqueda combinada de diseño y documentación técnica
    • Cruza las directrices de diseño con los detalles de implementación
    • Perfecta para guía de desarrollo de extremo a extremo

Ejemplos

Buscar Directrices de Diseño:

{
  "name": "search_human_interface_guidelines",
  "arguments": {
    "query": "Tab Bars",
    "platform": "iOS"
  }
}

Buscar Documentación Técnica:

{
  "name": "search_technical_documentation",
  "arguments": {
    "query": "Button",
    "framework": "SwiftUI"
  }
}

Búsqueda Unificada:

{
  "name": "search_unified",
  "arguments": {
    "query": "navigation",
    "platform": "iOS"
  }
}

🧪 Pruebas

npm test                # Run test suite
npm test               # Test functionality

# Interactive testing
npx @modelcontextprotocol/inspector apple-dev-mcp

🤝 Contribuciones

¡Agradecemos las contribuciones! La ayuda más necesaria:

  1. Correcciones del scraper cuando Apple cambie su sitio web
  2. Nuevas características y correcciones de errores
  3. Mejoras de documentación

Consulta CONTRIBUTING.md para las pautas.

⚖️ Legal y Atribución

Este proyecto opera bajo principios de uso justo con fines educativos. Todo el contenido incluye la atribución adecuada a Apple y respeta su propiedad intelectual.

Contenido obtenido de las Guías de Interfaz Humana de Apple.
© Apple Inc. Todos los derechos reservados. Proporcionado con fines educativos.

🙏 Agradecimientos

Hecho con ❤️ para la comunidad de desarrolladores

Llevando la excelencia de diseño de Apple directamente a tu flujo de trabajo de desarrollo asistido por IA.