Complemento MCP de diagnóstico de Xcode
Un complemento MCP (Protocolo de control de modelos) para extraer y ver errores y advertencias de los registros de compilación de Xcode.
Descripción general
Este complemento implementa la especificación del Protocolo de Control de Modelos (MCP) para proporcionar funciones de diagnóstico de Xcode a cualquier asistente de IA compatible. Se conecta al sistema de compilación de Xcode para extraer, analizar y mostrar diagnósticos (errores y advertencias) de tus proyectos Swift. Ayuda a los asistentes de IA a identificar rápidamente problemas en tu código sin tener que buscar manualmente en los registros de compilación.
Tenga en cuenta que, dado que esto funciona a nivel de registro, Xcode ya debe haber intentado una compilación antes de ejecutar esta herramienta.
Prerrequisitos
- sistema operativo macOS
- Xcode instalado
- Python 3.6+
Instalación
Instalación desde PyPI
La forma más sencilla de instalar el complemento Xcode Diagnostics MCP:
pip install mcp-xcode-diagnostics
Instalación desde GitHub
Puedes instalarlo directamente desde GitHub:
pip install git+https://github.com/leftspin/mcp-xcode-diagnostics.git
Instalación desde la fuente
Para instalar desde la fuente:
- Clonar o descargar este repositorio
- Instalar el complemento usando pip:
cd mcp-xcode-diagnostics
pip install .
El complemento ahora se puede utilizar con cualquier cliente compatible con MCP.
Características
- Enumera todos los proyectos de Xcode que tienen registros de compilación en DerivedData
- Extrae errores y advertencias del último registro de compilación de un proyecto específico
- Analiza diagnósticos complejos, incluidas notas asociadas y sugerencias de solución.
- Proporciona información detallada sobre cada problema, incluidas rutas de archivos, números de línea y mensajes de error.
- Optimizado para capturar advertencias relacionadas con la concurrencia de Swift
Tipos de diagnóstico admitidos
El complemento puede detectar y mostrar varios tipos de diagnósticos de Xcode, incluidos:
Errores
- Errores de sintaxis (por ejemplo, "se esperaba '{'" o "se esperaba expresión")
- Errores de tipo (por ejemplo, "no se puede convertir el valor del tipo X al tipo de argumento esperado Y")
- Identificadores no resueltos e importaciones faltantes
- Errores de conformidad del protocolo
- Fallos en la inferencia de parámetros genéricos
- Violaciones del control de acceso
Advertencias
- Variables, constantes y resultados no utilizados
- Conversiones implícitas que pueden perder precisión
- Código redundante o expresiones innecesarias
- Advertencias de desuso
- Problemas de interpolación de cadenas
- Advertencias de concurrencia de Swift, que incluyen:
- Advertencias globales compartidas y no aisladas sobre estados mutables
- Advertencias de aislamiento del actor principal
- Advertencias de concurrencia de conformidad con el protocolo
- Violaciones del aislamiento del actor
- Advertencias de compatibilidad del modo de lenguaje Swift 6
Notas y sugerencias para solucionar problemas
- Notas asociadas que proporcionan contexto adicional para errores y advertencias
- Sugerencias de solución que proponen cambios de código para resolver problemas
- Fragmentos de código que muestran el código problemático
Limitaciones
- Es posible que los formatos binarios/serializados en los registros de tiempo de ejecución no se analicen por completo
- Es posible que no se reconozcan algunos formatos de diagnóstico altamente especializados
- Los registros de compilación muy grandes pueden truncarse
- Es posible que los diagnósticos personalizados específicos del proyecto no estén categorizados correctamente
Herramientas MCP
El complemento proporciona dos herramientas MCP principales:
obtener_proyectos_xcode
Enumera todos los proyectos de Xcode con registros de compilación en el directorio DerivedData.
Parámetros : Ninguno
obtener_diagnósticos_del_proyecto
Obtiene información de diagnóstico del último registro de compilación de un proyecto específico.
Parámetros :
project_dir_name : Nombre del directorio del proyecto en DerivedData (por ejemplo, 'ProjectName-hash')include_warnings : si se deben incluir advertencias además de errores (valor predeterminado: Verdadero)
Para fines de depuración, el complemento guarda la salida del registro sin procesar en:
/tmp/xcode-mcp-debug.log - Registros principales de la aplicación/tmp/xcode-diagnostic-raw.log : salida sin procesar de los registros de actividad de Xcode
Ejemplo de salida
{
"success": true,
"log_file": "/path/to/build.xcactivitylog",
"timestamp": "2025-03-11T12:34:56.789",
"errors": [
{
"type": "error",
"message": "use of unresolved identifier 'NonExistentType'",
"file_path": "/path/to/MyFile.swift",
"line_number": 42,
"column": 15,
"code": " let x: NonExistentType = value",
"notes": []
}
],
"warnings": [
{
"type": "warning",
"message": "static property 'sharedInstance' is not concurrency-safe because it is nonisolated global shared mutable state; this is an error in the Swift 6 language mode",
"file_path": "/path/to/SharedManager.swift",
"line_number": 10,
"column": 16,
"code": " static var sharedInstance: SharedManager?",
"notes": [
{
"type": "note",
"message": "convert 'sharedInstance' to a 'let' constant to make 'Sendable' shared state immutable",
"file_path": "/path/to/SharedManager.swift",
"line_number": 10,
"column": 16
}
]
}
],
"error_count": 1,
"warning_count": 1
}
Pruebas
El complemento incluye un conjunto de pruebas para verificar la funcionalidad de análisis:
# Run all tests
python -m unittest test_xcode_diagnostics.py
Licencia
Este proyecto está disponible bajo la licencia MIT.