Apple Doc MCP

Apple Doc MCP

Un servidor de Model Context Protocol (MCP) que proporciona acceso fluido a la Documentación para Desarrolladores de Apple directamente dentro de tu asistente de codificación con IA. Nota: Hola chicos, ¡gracias por revisar este MCP! Como he estado trabajando en él de forma regular, y por eso se está volviendo muy costoso construirlo y mejorarlo para que funcione en diferentes plataformas, mientras añado nuevas funciones (los tokens no son baratos, ¿sabéis?).

Si encuentras útil este MCP, realmente agradecería que hicieras clic en el botón ❤️ Patrocinar de arriba, ¡cualquier contribución es apreciada! gracias.

📋 Registro de cambios

¡Gracias al equipo de Github por su apoyo! y gracias a @billibala, @theoddbrick, @christopherbattlefrontlegal por patrocinar! sois increíbles.

• El historial completo de versiones está en CHANGELOG.md.

• 1.9.6

  • CORRECCIÓN PRINCIPAL: Se simplificó search_symbols para que sea más predecible para los agentes de IA
  • Se añadió resolución exacta de símbolos dentro de search_symbols para consultas como GridItem, View y ButtonStyle
  • Se cambió search_symbols para devolver resultados de símbolos primero, con artículos y guías separados en su propia sección
  • Se corrigió el comportamiento de comodines para que la búsqueda de respaldo respete los patrones de * y ? en lugar de degradarse a coincidencias de subcadena simples
  • Se eliminaron mensajes de búsqueda engañosos sobre descargas en segundo plano e indexación "completa"
  • Se eliminaron rutas de código de búsqueda muertas o sin usar que añadían confusión sin mejorar los resultados
  • Se corrigió la inicialización del índice en la primera búsqueda para que la búsqueda de símbolos basada en caché termine de construirse antes de usar los resultados

• 1.9.1

  • Se movieron los documentos en caché a .cache/ para mantener limpio el repositorio
  • Se redirigió el registro de MCP a stderr para que el stdout del protocolo se mantenga limpio (esto estaba rompiendo la búsqueda de símbolos de codex)

Instalación

VS Code

1. Abre la Paleta de Comandos (Shift+Cmd+P).
2. Ejecuta MCP: Add Server.
3. Cuando se te pida el tipo de servidor, elige npm.
4. Introduce este paquete:

apple-doc-mcp-server

Claude Code:

claude mcp add apple-docs -- npx apple-doc-mcp-server@latest

OpenAI Codex:

codex mcp add apple-doc-mcp -- npx apple-doc-mcp-server@latest

Manual:

{
	"mcpServers": {
		"apple-docs": {
			"command": "npx",
			"args": ["apple-doc-mcp-server@latest"]
		}
	}
}

Local:

yarn install
yarn build

{
  "mcpServers": {
    "apple-docs": {
      "command": "node",
      "args": ["/absolute/path/to/apple-doc-mcp/dist/index.js"]
    }
  }
}

Consejos de búsqueda

• Usa nombres exactos de API cuando los conozcas ("GridItem", "ButtonStyle", "View").
• Empieza amplio (p. ej. "tab", "animation", "gesture").
• Prueba sinónimos ("sheet" frente a "modal", "toolbar" frente a "tabbar").
• Usa comodines ("Grid*", "*Item", "Lazy*") para coincidencias flexibles.
• Usa varias palabras clave ("tab view layout") para acotar resultados.
• Si no aparece nada, vuelve a ejecutar discover_technologies con otra palabra clave o elige otro framework.
• search_symbols devuelve los símbolos primero y lista los artículos coincidentes por separado.

Herramientas disponibles

• discover_technologies – examina/filtra frameworks antes de seleccionar uno.
• choose_technology – establece el framework activo; necesario antes de buscar en la documentación.
• current_technology – muestra la selección actual y los siguientes pasos rápidos.
• search_symbols – búsqueda con prioridad de símbolos, resolución de nombres exactos, soporte de comodines y resultados de artículos separados.
• get_documentation – abre documentación detallada de un símbolo o ruta de documentación conocidos.
• get_version – obtiene información de la versión actual del servidor MCP.