vHAL MCP Server
Busca documentación y código fuente de la capa de abstracción de hardware de vehículos Android (vHAL) desde un clon de repositorio local.
Documentación
Servidor MCP vHAL
Servidor MCP para documentación y análisis de código fuente de la Capa de Abstracción de Hardware de Vehículos (vHAL) de Android. Este servidor proporciona herramientas inteligentes para explorar propiedades vHAL, comprender sus relaciones e implementar sistemas de control de clima automotriz.
Descripción general
El Servidor MCP vHAL ayuda a los desarrolladores de Android Automotive al proporcionar:
- Análisis de propiedades: Descubra propiedades vHAL y sus relaciones
- Búsqueda de código fuente: Encuentre implementaciones de código fuente de Android
- Orientación de implementación: Obtenga recomendaciones de implementación paso a paso
- Resúmenes de documentación: Acceda a información seleccionada de la documentación vHAL
Demostración
Vea el Servidor MCP vHAL en acción:
https://github.com/user-attachments/assets/6fcdc5fb-6cbb-4c69-9528-fa3bdee4acb1
Ejemplo: Análisis de propiedades HVAC y orientación de implementación usando Claude Desktop con el Servidor MCP vHAL
Características
Herramientas principales
summarize_vhal(question)
- Resume la implementación de vHAL según preguntas específicas
- Analiza la documentación automotriz de Android
- Proporciona respuestas contextuales para el desarrollo de vHAL
lookup_android_source_code(keyword, category)
- Busca en el código fuente de Android propiedades vHAL
- Devuelve definiciones de propiedades con IDs y categorías
- Proporciona enlaces directos a ubicaciones del código fuente
discover_related_properties(property_or_category)
- Analiza relaciones y dependencias de propiedades
- Sugiere orden de implementación para funciones complejas
- Agrupa propiedades por categorías funcionales
analyze_vhal_implementation(property_name)
- Muestra análisis detallado del código fuente para propiedades específicas
- Proporciona ejemplos de implementación y patrones de uso
- Incluye análisis de dependencias y mejores prácticas
generate_vhal_implementation_code(...)
- Genera código completo de implementación de propiedades VHAL para AAOS
- Crea todos los archivos necesarios, configuraciones, pruebas y documentación
- Admite todos los tipos de datos VHAL, grupos de propiedades y modos de acceso
- Incluye definiciones HAL, APIs de Java, pruebas y configuraciones de compilación
generate_vhal_pr_message(...)
- Genera mensajes completos de solicitudes de extracción para implementaciones VHAL
- Crea descripciones de PR estructuradas con detalles técnicos y requisitos de prueba
- Incluye títulos profesionales, resúmenes de cambios y listas de verificación de revisión
- Formato listo para copiar y pegar para integración con GitHub/GitLab
validate_vhal_sources_and_enhance_summary(question, include_source_validation, max_sources_to_check)
- Resumen vHAL mejorado con transparencia completa de fuentes y validación
- Valida la accesibilidad de URLs para detectar enlaces de documentación rotos o movidos
- Proporciona puntuación de confianza basada en la confiabilidad y accesibilidad de la fuente
- Muestra citas claras con tiempos de respuesta y fechas de última modificación
- Sugiere fuentes alternativas para URLs fallidas
- Distingue entre datos en caché vs. datos en vivo para transparencia
validate_vhal_property_request(property_name, property_description, ...)
- Valida solicitudes de propiedades vHAL siguiendo las mejores prácticas de Android
- Verifica si la propiedad ya existe en la última versión de Android (Android 16)
- Recomienda usar propiedades Android existentes cuando estén disponibles
- Genera propiedades VENDOR_ con la convención de nomenclatura adecuada cuando sea necesario
- Proporciona análisis completo con puntuación de similitud y recomendaciones
- Admite todos los tipos de datos VHAL, grupos de propiedades y configuraciones
- Se integra con herramientas de generación de código existentes para una implementación completa
Instalación
Requisitos previos
- Python 3.12 o superior
- Conexión a Internet para el raspado de documentación
- Cliente compatible con MCP (Claude Desktop, Zed u otros clientes MCP)
Configuración local
-
Clone el repositorio
Usando HTTPS:
git clone https://github.com/feevlic/vhal-mcp-server.gitUsando SSH:
git clone git@github.com:feevlic/vhal-mcp-server.git -
Navegue al directorio del proyecto
cd vhal-mcp-server -
Instale las dependencias
pip install -e .
Configuración del cliente MCP
Configuración de Claude Desktop
-
Encuentre su ruta de instalación de
uvwhich uv -
Localice su archivo de configuración de Claude Desktop
- macOS:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%/Claude/claude_desktop_config.json
- macOS:
-
Agregue la configuración del servidor
Edite el archivo de configuración y agregue lo siguiente (reemplace las rutas con sus rutas reales):
{ "mcpServers": { "vhal-mcp-server": { "command": "/Users/[]/.local/bin/uv", "args": ["run", "--directory", "/Users/[]/vhal-mcp-server", "python", "main.py"], "env": { "PYTHONPATH": "/Users/[]/vhal-mcp-server" } } } }
Puede encontrar un ejemplo en la carpeta de configuración.
Importante:
- Reemplace
/path/to/your/uvcon la salida del paso 1 (por ejemplo,/Users/yourusername/.local/bin/uv) - Reemplace
/path/to/vhal-mcp-servercon la ruta real donde clonó el repositorio - En macOS, las aplicaciones GUI como Claude Desktop pueden no tener acceso al PATH de su shell, por lo que se requieren rutas completas
-
Reinicie Claude Desktop
Después de guardar el archivo de configuración, cierre y reinicie completamente Claude Desktop para que se cargue el servidor MCP.
-
Permita el acceso al servidor MCP
Cuando haga una pregunta que requiera las herramientas vHAL por primera vez, Claude le pedirá que permita que el servidor MCP use sus herramientas. Haga clic en "Permitir" para habilitar las capacidades de análisis vHAL.
Uso
Uso básico
El servidor expone herramientas MCP que se pueden usar a través de clientes compatibles. Cada herramienta acepta parámetros específicos y devuelve información estructurada sobre propiedades e implementaciones vHAL.
Ejemplos de indicaciones para principiantes
Comience con estas indicaciones simples para explorar las capacidades de vHAL:
Descubrimiento básico de propiedades
Show me all HVAC-related properties and their IDs
Preguntas simples de implementación
How do I control the fan speed in Android Automotive?
Búsqueda de propiedades
Find Android source code for seat heating properties
Control básico de temperatura
What properties do I need to set the cabin temperature?
Comprensión de tipos de propiedades
Explain the HVAC_POWER_ON property and how to use it
Ejemplos de indicaciones avanzadas
Una vez familiarizado con los conceptos básicos, pruebe estas indicaciones completas:
Implementación completa del sistema
I need to implement a climate control system. Can you:
1. Find all HVAC-related properties
2. Explain their relationships and dependencies
3. Show me the Android source code implementation
4. Provide a step-by-step implementation guide
Please give me a complete analysis for building this system.
Control de clima multizona
Analyze the implementation requirements for a dual-zone HVAC system. Include:
- Property relationships between driver and passenger zones
- Dependencies and implementation order
- Source code examples from Android
- Best practices for zone management
Sistema de memoria de asientos
Design a comprehensive seat memory system that includes:
- Position storage and recall (8-way adjustment)
- Heating and cooling integration
- Memory profile management
- Safety considerations and dependencies
Show me the vHAL properties needed and implementation approach.
Funciones críticas de seguridad
I'm implementing defrost and safety features. Analyze:
- Priority systems for defrost override
- Integration with HVAC main system
- Emergency defrost activation
- Window clearing effectiveness
Provide source code examples and safety considerations.
Optimización de rendimiento
Optimize my HVAC implementation for energy efficiency:
- Auto mode algorithms
- Fan speed optimization
- AC compressor management
- Integration with vehicle power management
Include Android source examples and power consumption strategies.
Desarrollo de propiedades personalizadas
I want to add a new custom HVAC feature for air quality monitoring. Help me:
- Understand the property definition process
- Find similar existing properties for reference
- Design the property specification
- Plan the HAL implementation approach
Ejemplos de generación de código VHAL
Use la herramienta generate_vhal_implementation_code para crear implementaciones VHAL completas:
Sistema inteligente de iluminación del tablero
Generate a complete VHAL implementation for a smart dashboard lighting system with the following specifications:
- Property Name: DASHBOARD_SMART_LIGHTING_MODE
- Property ID: 0x15400B01
- Type: INT32 (enumerated values)
- Group: LIGHTS
- Access: READ_WRITE
- Change Mode: ON_CHANGE
- Description: Smart dashboard lighting control with adaptive brightness and color temperature
- Enum Values: OFF=0, AUTO=1, DAY=2, NIGHT=3, CUSTOM=4
- Dependencies: NIGHT_MODE, CABIN_LIGHTS_STATE
Please use the generate_vhal_implementation_code tool.
Gestión de carga de vehículos eléctricos
I need to implement a comprehensive EV charging management system. Create a VHAL property with these requirements:
- Property Name: EV_CHARGING_PORT_STATUS
- Property ID: 0x15400C01
- Type: INT32 (enum)
- Group: POWER
- Access: READ (status monitoring only)
- Change Mode: ON_CHANGE
- Description: Electric vehicle charging port status and connection state
- Enum Values: DISCONNECTED=0, CONNECTED=1, CHARGING=2, ERROR=3, COMPLETE=4, SCHEDULED=5
- Dependencies: EV_BATTERY_LEVEL, EV_CHARGING_RATE
- Areas: GLOBAL
Generate the complete implementation using generate_vhal_implementation_code.
Control avanzado de zonas HVAC
Implement an advanced HVAC zone control system for precise temperature management:
- Property Name: HVAC_ZONE_CLIMATE_PROFILE
- Property ID: 0x15400D01
- Type: FLOAT
- Group: HVAC
- Access: READ_WRITE
- Change Mode: CONTINUOUS
- Description: Advanced HVAC zone climate profile with precise temperature control
- Units: celsius
- Min Value: 16.0
- Max Value: 32.0
- Areas: ["SEAT_ROW_1_LEFT", "SEAT_ROW_1_RIGHT", "SEAT_ROW_2_LEFT", "SEAT_ROW_2_RIGHT"]
- Dependencies: HVAC_TEMPERATURE_SET, HVAC_FAN_SPEED
- Sample Rate: 0.5 Hz (update every 2 seconds)
Use generate_vhal_implementation_code to create the full implementation.
Ajuste biométrico de asientos
Create a biometric-based seat adjustment system:
- Property Name: SEAT_BIOMETRIC_PROFILE
- Property ID: 0x15400E01
- Type: STRING
- Group: SEAT
- Access: READ_WRITE
- Change Mode: ON_CHANGE
- Description: Biometric-based automatic seat adjustment with user recognition
- Areas: ["SEAT_ROW_1_LEFT", "SEAT_ROW_1_RIGHT"]
- Dependencies: SEAT_HEIGHT_POS, SEAT_FORE_AFT_POS, SEAT_RECLINE_ANGLE
Generate the complete VHAL implementation.
Ejemplos de generación de solicitudes de extracción VHAL
Use la herramienta generate_vhal_pr_message para crear mensajes profesionales de solicitudes de extracción:
PR de iluminación inteligente del tablero
Generate a comprehensive pull request message for my smart dashboard lighting implementation:
- Property Name: DASHBOARD_SMART_LIGHTING_MODE
- Property ID: 0x15400B01
- Type: INT32
- Group: LIGHTS
- Access: READ_WRITE
- Change Mode: ON_CHANGE
- Description: Smart dashboard lighting control with adaptive brightness and color temperature
- Enum Values: {"OFF": 0, "AUTO": 1, "DAY": 2, "NIGHT": 3, "CUSTOM": 4}
- Dependencies: ["NIGHT_MODE", "CABIN_LIGHTS_STATE"]
- JIRA Ticket: AUTO-1234
- Reviewer Suggestions: ["Verify power consumption impact", "Test night mode transitions"]
Please use the generate_vhal_pr_message tool.
PR del sistema de carga de vehículos eléctricos
Create a pull request message for my electric vehicle charging management system:
- Property Name: EV_CHARGING_PORT_STATUS
- Property ID: 0x15400C01
- Type: INT32
- Group: POWER
- Access: READ
- Change Mode: ON_CHANGE
- Description: Electric vehicle charging port status and connection state
- Enum Values: {"DISCONNECTED": 0, "CONNECTED": 1, "CHARGING": 2, "ERROR": 3, "COMPLETE": 4, "SCHEDULED": 5}
- Dependencies: ["EV_BATTERY_LEVEL", "EV_CHARGING_RATE"]
- Areas: ["GLOBAL"]
- Breaking Change: false
Generate the complete PR message.
PR de control avanzado de zonas HVAC
Generate a pull request message for my advanced HVAC zone control implementation:
- Property Name: HVAC_ZONE_CLIMATE_PROFILE
- Property ID: 0x15400D01
- Type: FLOAT
- Group: HVAC
- Access: READ_WRITE
- Change Mode: CONTINUOUS
- Description: Advanced HVAC zone climate profile with precise temperature control
- Units: celsius
- Min Value: 16.0
- Max Value: 32.0
- Areas: ["SEAT_ROW_1_LEFT", "SEAT_ROW_1_RIGHT", "SEAT_ROW_2_LEFT", "SEAT_ROW_2_RIGHT"]
- Dependencies: ["HVAC_TEMPERATURE_SET", "HVAC_FAN_SPEED"]
- Sample Rate: 0.5
- Breaking Change: false
- JIRA Ticket: HVAC-567
- Reviewer Suggestions: ["Review energy efficiency impact", "Validate zone isolation"]
Create a professional PR message with all technical details and checklists.
Ejemplos de validación de propiedades VHAL
Use la herramienta validate_vhal_property_request para seguir las mejores prácticas de Android y validar solicitudes de propiedades:
Verificar propiedades existentes
I want to implement a seat heating control feature. Can you validate if I should use an existing Android property or create a new VENDOR_ property?
- Property Name: SEAT_HEATING_CONTROL
- Description: Control seat heating levels for driver and passenger seats
- Property Type: INT32
- Min Value: 0
- Max Value: 5
- Areas: ["SEAT_ROW_1_LEFT", "SEAT_ROW_1_RIGHT"]
Please use the validate_vhal_property_request tool.
Validar propiedades de control de clima
Validate this climate control property request:
- Property Name: CLIMATE_AUTO_MODE
- Description: Enable automatic climate control mode
- Property Type: BOOLEAN
- Group: HVAC
- Access: READ_WRITE
- Change Mode: ON_CHANGE
Use validate_vhal_property_request to check if this exists in Android 16.
Validación de funciones personalizadas del vehículo
I need to implement a custom vehicle feature. Please validate:
- Property Name: VEHICLE_AMBIENT_SOUND_CONTROL
- Description: Control ambient sound system for enhanced driving experience
- Property Type: INT32
- Group: VENDOR
- Access: READ_WRITE
- Change Mode: ON_CHANGE
- Enum Values: {"OFF": 0, "NATURE": 1, "CITY": 2, "HIGHWAY": 3, "CUSTOM": 4}
- Dependencies: ["AUDIO_VOLUME", "CABIN_LIGHTS_STATE"]
Please use validate_vhal_property_request to determine if I should create a VENDOR_ property.
Validación avanzada de propiedades
Validate this advanced property request with full specifications:
- Property Name: BIOMETRIC_DRIVER_RECOGNITION
- Description: Biometric driver recognition system for personalized vehicle settings
- Property Type: STRING
- Group: VENDOR
- Access: READ_WRITE
- Change Mode: ON_CHANGE
- Units: none
- Areas: ["GLOBAL"]
- Dependencies: ["SEAT_MEMORY_SELECT", "MIRROR_Y_POS", "HVAC_TEMPERATURE_SET"]
- Sample Rate: 0.1 Hz
Use validate_vhal_property_request to check Android 16 compatibility and get implementation guidance.
Validación de tipos de propiedades
I'm implementing a tire pressure monitoring system. Please validate:
- Property Name: TIRE_PRESSURE_MONITORING_DETAILED
- Description: Detailed tire pressure monitoring with per-tire data and alerts
- Property Type: FLOAT_VEC
- Group: POWER
- Access: READ
- Change Mode: CONTINUOUS
- Units: psi
- Min Value: 0.0
- Max Value: 100.0
- Areas: ["WHEEL_LEFT_FRONT", "WHEEL_RIGHT_FRONT", "WHEEL_LEFT_REAR", "WHEEL_RIGHT_REAR"]
- Sample Rate: 1.0 Hz
Use validate_vhal_property_request to determine if Android 16 has equivalent functionality.
Indicación experta: Desarrollo completo de sistemas VHAL
Esta indicación de nivel experto demuestra el uso de las 6 herramientas MCP en un flujo de trabajo integral para desarrollar un sistema automotriz completo:
I'm developing a next-generation intelligent climate control system for luxury electric vehicles. This system needs to integrate multiple subsystems and provide personalized comfort experiences. Please help me design and implement this system using a comprehensive analysis approach:
**Phase 1: Discovery & Research (Tools 1-2)**
First, help me understand the complete landscape:
1. explain the overall VHAL climate control architecture, focusing on:
- Multi-zone HVAC systems
- Integration with seat heating/cooling
- Energy efficiency considerations for EVs
- Safety and emergency override systems
2. find all climate-related properties, including:
- HVAC properties (search: "HVAC")
- Seat thermal properties (search: "SEAT")
- Power management properties (search: "POWER")
- Any auxiliary heating properties (search: "HEAT")
**Phase 2: System Analysis & Dependencies (Tool 3)**
3. analyze the complete ecosystem for:
- "HVAC_TEMPERATURE_SET" - understand temperature control relationships
- "SEAT_HEAT" - analyze seat thermal dependencies
- "HVAC_POWER_ON" - understand system power relationships
- "HVAC_FAN_SPEED" - analyze airflow control dependencies
**Phase 3: Implementation Deep-Dive (Tool 4)**
4. get detailed source code analysis for:
- "HVAC_TEMPERATURE_SET" - see how Android implements temperature control
- "HVAC_AUTO_ON" - understand automatic mode implementation
- "SEAT_HEAT_LEFT" - analyze seat heating implementation patterns
- "HVAC_AC_ON" - understand AC compressor control
**Phase 5: Property Validation (Tool 5)**
5. Before implementing, validate the property request:
- Property Name: CLIMATE_INTELLIGENT_PROFILE
- Description: Intelligent climate control with predictive comfort algorithms, energy optimization, and personalized user profiles
- Property Type: INT32
- Group: HVAC
- Access: READ_WRITE
- Change Mode: ON_CHANGE
- Enum Values: {"PROFILE_ECO": 0, "PROFILE_COMFORT": 1, "PROFILE_SPORT": 2, "PROFILE_CUSTOM": 3, "PROFILE_SLEEP": 4, "PROFILE_DEFROST_PRIORITY": 5}
- Dependencies: ["HVAC_TEMPERATURE_SET", "HVAC_FAN_SPEED", "SEAT_HEAT_LEFT", "SEAT_HEAT_RIGHT", "HVAC_AC_ON", "EV_BATTERY_LEVEL"]
- Areas: ["GLOBAL", "SEAT_ROW_1_LEFT", "SEAT_ROW_1_RIGHT"]
Use validate_vhal_property_request to determine if this should be a VENDOR_ property or if Android 16 has equivalent functionality.
**Phase 6: Custom Implementation (Tool 6)**
6. Based on the validation results, create the property implementation:
- Property Name: CLIMATE_INTELLIGENT_PROFILE
- Property ID: 0x15400F01
- Type: INT32 (enumerated values)
- Group: HVAC
- Access: READ_WRITE
- Change Mode: ON_CHANGE
- Description: Intelligent climate control with predictive comfort algorithms, energy optimization, and personalized user profiles
- Enum Values: PROFILE_ECO=0, PROFILE_COMFORT=1, PROFILE_SPORT=2, PROFILE_CUSTOM=3, PROFILE_SLEEP=4, PROFILE_DEFROST_PRIORITY=5
- Dependencies: HVAC_TEMPERATURE_SET, HVAC_FAN_SPEED, SEAT_HEAT_LEFT, SEAT_HEAT_RIGHT, HVAC_AC_ON, EV_BATTERY_LEVEL
- Units: none
- Areas: ["GLOBAL", "SEAT_ROW_1_LEFT", "SEAT_ROW_1_RIGHT"]
7. Please also add a pull request message i can add to the Pull request once i implemented it.
**Expected Deliverables:**
After running this comprehensive analysis, I expect to receive:
1. **Complete System Understanding** - architectural overview and best practices
2. **Property Inventory** - all relevant properties with IDs and locations
3. **Dependency Maps** - implementation order and relationships
4. **Implementation Patterns** - real Android source code examples
5. **Property Validation** - Android best practices validation and recommendations
6. **Production-Ready Code** - complete implementation files
7. **Pull Request Text** - Copy and Paste Pull request text
This comprehensive approach will give me everything needed to implement a production-quality intelligent climate control system.
Características del generador de código VHAL
La herramienta generate_vhal_implementation_code crea implementaciones VHAL completas y listas para producción:
Archivos generados
Para cada propiedad VHAL, el generador crea:
Archivos HAL principales:
types.hal- Definición de propiedad y enumeracionesDefaultConfig.h- Configuración de propiedadEmulatedVehicleHal.cpp- Lógica de implementaciónVehicleProperty.aidl- Interfaz AIDL
Integración con el framework:
VehiclePropertyIds.java- Constantes de JavaCarPropertyManager.java- Métodos de API- Archivos JSON de configuración
Pruebas:
VehicleHalTest.cpp- Pruebas unitarias de C++VehiclePropertyTest.java- Pruebas de integración de Java
Configuración del sistema:
- Reglas de SEPolicy
- Configuraciones de compilación
- Documentación
Parámetros de la herramienta
Requeridos:
name: Nombre de la propiedad (por ejemplo, "HVAC_STEERING_WHEEL_HEAT")property_id: ID único de la propiedad (formato hexadecimal, por ejemplo, "0x15400A03")property_type: Tipo de datos (BOOLEAN, INT32, INT64, FLOAT, STRING, BYTES, *_VEC, MIXED)group: Grupo de propiedad (HVAC, SEAT, LIGHTS, POWER, CLIMATE, etc.)access: Modo de acceso (READ, WRITE, READ_WRITE)change_mode: Modo de cambio (STATIC, ON_CHANGE, CONTINUOUS)description: Descripción de la propiedad para documentación
Opcionales:
units: Unidades (por ejemplo, "celsius", "rpm")min_value: Valor mínimo para tipos numéricosmax_value: Valor máximo para tipos numéricosareas: Lista de áreas/zonas del vehículoenum_values: Diccionario de nombres y valores de enumeraciones para propiedades de enumeración INT32dependencies: Lista de nombres de propiedades dependientessample_rate_hz: Tasa de muestreo para propiedades continuas
Tipos de propiedades admitidos
Tipos básicos:
- BOOLEAN: Valores verdadero/falso
- INT32: Enteros de 32 bits
- INT64: Enteros de 64 bits
- FLOAT: Números de punto flotante
- STRING: Valores de texto
- BYTES: Datos binarios
Tipos vectoriales:
- INT32_VEC: Matrices de enteros
- FLOAT_VEC: Matrices de flotantes
- STRING_VEC: Matrices de cadenas
- BYTES_VEC: Matrices de datos binarios
Tipos especiales:
- MIXED: Datos estructurados complejos
Grupos de propiedades
- BODY: Sistemas de control de carrocería
- CABIN: Controles del habitáculo interior
- CLIMATE: Sistemas de control de clima
- DISPLAY: Pantalla e infoentretenimiento
- ENGINE: Gestión del motor
- HVAC: Calefacción, ventilación y aire acondicionado
- INFO: Información del vehículo
- INSTRUMENT_CLUSTER: Instrumentos del tablero
- LIGHTS: Sistemas de iluminación
- MIRROR: Controles de espejos
- POWER: Gestión de energía
- SEAT: Controles de asientos
- VEHICLE_MAP_SERVICE: Servicios de navegación
- WINDOW: Controles de ventanas
- VENDOR: Propiedades específicas del proveedor
Salida generada
Cuando use el generador de código, produce:
- Resumen completo - Configuración y descripción general de la propiedad
- Archivos generados - Los 10+ archivos de implementación necesarios con resaltado de sintaxis
- Guía de implementación - Instrucciones de integración paso a paso
- Ejemplos de uso - Código de muestra para usar la propiedad
- Comandos de compilación - Comandos de compilación y prueba de AAOS
Casos de uso
Desarrollo de sistemas de control de clima
Implemente sistemas HVAC completos con relaciones de propiedad adecuadas:
- Control de temperatura: Calefacción y refrigeración multizona
- Gestión del ventilador: Control de velocidad y dirección con retroalimentación
- Aire acondicionado: Control del compresor de CA y recirculación
- Calefacción auxiliar: Calentadores de asientos, volante y espejos
- Funciones de seguridad: Capacidades de desempañado y descongelación
Sistemas de control de asientos
Desarrolle funciones avanzadas de control de asientos:
- Sistemas de memoria: Almacenamiento y recuperación de posiciones
- Funciones de confort: Calefacción, refrigeración y funciones de masaje
- Control de movimiento: Posicionamiento y ajuste multieje
- Integración de seguridad: Detección de ocupación y coordinación de airbags
Descubrimiento y análisis de propiedades
Comprenda los ecosistemas de propiedades vHAL:
- Mapeo de dependencias: Identifique relaciones entre propiedades
- Planificación de implementación: Obtenga orientación de desarrollo paso a paso
- Análisis de código fuente: Acceda a implementaciones reales de Android
- Mejores prácticas: Aprenda de patrones de propiedades existentes
Configuración
Integración con clientes MCP
Para usar con clientes compatibles con MCP, configure el endpoint del servidor y asegure el registro adecuado de herramientas. El servidor descubre y expone automáticamente todas las herramientas de análisis vHAL disponibles.
Optimización del rendimiento
El servidor usa mecanismos de raspado paralelo y almacenamiento en caché para un rendimiento óptimo:
- Raspado paralelo de documentación: Obtención concurrente de documentación de Android
- Caché de base de datos de propiedades: Almacenamiento en memoria de propiedades de acceso frecuente
- Caché de análisis de código fuente: Operaciones de análisis repetidas optimizadas
Desarrollo
Estructura del proyecto
vhal-mcp-server/
├── src/vhal_mcp_server/
│ ├── server.py # Main MCP server implementation
│ ├── core/
│ │ ├── analyzers.py # Source code analysis tools
│ │ ├── database.py # Property database and lookups
│ │ ├── property_validator.py # Property validation and VENDOR_ generation
│ │ ├── scrapers.py # Documentation scraping utilities
│ │ └── source_validator.py # Source validation utilities
│ ├── utils/
│ │ ├── relationships.py # Property relationship analysis
│ │ └── summarizers.py # Documentation summarization
│ ├── generators/
│ │ ├── code_generator.py # VHAL code generation
│ │ └── pr_generator.py # Pull request generation
│ └── models.py # Data models and structures
└── tests/ # Test suite
Pruebas
Ejecute el conjunto de pruebas:
python -m pytest test_vhal.py -v
Contribuciones
- Haga un fork del repositorio
- Cree una rama de características
- Implemente sus cambios con pruebas
- Envíe una solicitud de extracción
Requisitos
- mcp[cli] >= 1.10.1 - Implementación del Model Context Protocol
- requests >= 2.31.0 - Cliente HTTP para extracción de documentación
- beautifulsoup4 >= 4.12.0 - Análisis de HTML para documentación
- lxml >= 4.9.0 - Procesamiento de XML/HTML
Licencia
Este proyecto está licenciado bajo la Licencia MIT. Consulta el archivo LICENSE para más detalles.
Soporte
Para preguntas, problemas o contribuciones:
- Repositorio: https://github.com/feevlic/vhal-mcp-server
- Problemas: https://github.com/feevlic/vhal-mcp-server/issues
- Documentación: Consulta la documentación de Android vHAL en https://source.android.com/docs/automotive/vhal