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

  1. Clone el repositorio

    Usando HTTPS:

    git clone https://github.com/feevlic/vhal-mcp-server.git
    

    Usando SSH:

    git clone git@github.com:feevlic/vhal-mcp-server.git
    
  2. Navegue al directorio del proyecto

    cd vhal-mcp-server
    
  3. Instale las dependencias

    pip install -e .
    

Configuración del cliente MCP

Configuración de Claude Desktop

  1. Encuentre su ruta de instalación de uv

    which uv
    
  2. 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
  3. 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/uv con la salida del paso 1 (por ejemplo, /Users/yourusername/.local/bin/uv)
  • Reemplace /path/to/vhal-mcp-server con 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
  1. 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.

  2. 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 enumeraciones
  • DefaultConfig.h - Configuración de propiedad
  • EmulatedVehicleHal.cpp - Lógica de implementación
  • VehicleProperty.aidl - Interfaz AIDL

Integración con el framework:

  • VehiclePropertyIds.java - Constantes de Java
  • CarPropertyManager.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éricos
  • max_value: Valor máximo para tipos numéricos
  • areas: Lista de áreas/zonas del vehículo
  • enum_values: Diccionario de nombres y valores de enumeraciones para propiedades de enumeración INT32
  • dependencies: Lista de nombres de propiedades dependientes
  • sample_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:

  1. Resumen completo - Configuración y descripción general de la propiedad
  2. Archivos generados - Los 10+ archivos de implementación necesarios con resaltado de sintaxis
  3. Guía de implementación - Instrucciones de integración paso a paso
  4. Ejemplos de uso - Código de muestra para usar la propiedad
  5. 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

  1. Haga un fork del repositorio
  2. Cree una rama de características
  3. Implemente sus cambios con pruebas
  4. 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:

Recursos Relacionados