vHAL MCP Server

Pesquise a documentação e o código-fonte da Camada de Abstração de Hardware de Veículos Android (vHAL) a partir de um clone do repositório local.

GitHub

Experimente este MCPPatrocinado

Documentação

Servidor MCP vHAL

Servidor MCP para documentação e análise de código-fonte do Android Vehicle Hardware Abstraction Layer (vHAL). Este servidor fornece ferramentas inteligentes para explorar propriedades vHAL, entender seus relacionamentos e implementar sistemas automotivos de controle climático.

Visão Geral

O vHAL MCP Server ajuda desenvolvedores Android Automotive fornecendo:

Análise de Propriedades: Descubra propriedades vHAL e seus relacionamentos
Consulta de Código-Fonte: Encontre implementações no código-fonte Android
Orientação de Implementação: Obtenha recomendações de implementação passo a passo
Resumo de Documentação: Acesse insights selecionados da documentação vHAL

Demonstração

Veja o vHAL MCP Server em ação:

https://github.com/user-attachments/assets/6fcdc5fb-6cbb-4c69-9528-fa3bdee4acb1

Exemplo: Analisando propriedades HVAC e orientação de implementação usando Claude Desktop com o vHAL MCP Server

Recursos

Ferramentas Principais

summarize_vhal(question)

Resume a implementação vHAL com base em perguntas específicas
Analisa documentação automotiva Android
Fornece respostas contextuais para desenvolvimento vHAL

lookup_android_source_code(keyword, category)

Pesquisa código-fonte Android para propriedades vHAL
Retorna definições de propriedades com IDs e categorias
Fornece links diretos para locais no código-fonte

discover_related_properties(property_or_category)

Analisa relacionamentos e dependências de propriedades
Sugere ordem de implementação para recursos complexos
Agrupa propriedades por categorias funcionais

analyze_vhal_implementation(property_name)

Mostra análise detalhada de código-fonte para propriedades específicas
Fornece exemplos de implementação e padrões de uso
Inclui análise de dependências e melhores práticas

generate_vhal_implementation_code(...)

Gera código completo de implementação de propriedades VHAL para AAOS
Cria todos os arquivos necessários, configurações, testes e documentação
Suporta todos os tipos de dados VHAL, grupos de propriedades e modos de acesso
Inclui definições HAL, APIs Java, testes e configurações de build

generate_vhal_pr_message(...)

Gera mensagens abrangentes de pull request para implementações VHAL
Cria descrições estruturadas de PR com detalhes técnicos e requisitos de teste
Inclui títulos profissionais, resumos de alterações e listas de verificação de revisão
Formato pronto para copiar e colar para integração GitHub/GitLab

validate_vhal_sources_and_enhance_summary(question, include_source_validation, max_sources_to_check)

Resumo vHAL aprimorado com transparência completa de fontes e validação
Valida acessibilidade de URLs para detectar links de documentação quebrados ou movidos
Fornece pontuação de confiança baseada na confiabilidade e acessibilidade da fonte
Mostra citações claras com tempos de resposta e datas de última modificação
Sugere fontes alternativas para URLs com falha
Distingue entre dados em cache vs. dados ao vivo para transparência

validate_vhal_property_request(property_name, property_description, ...)

Valida solicitações de propriedades vHAL seguindo as melhores práticas Android
Verifica se a propriedade já existe na versão mais recente do Android (Android 16)
Recomenda usar propriedades Android existentes quando disponíveis
Gera propriedades VENDOR_ com convenção de nomenclatura adequada quando necessário
Fornece análise abrangente com pontuação de similaridade e recomendações
Suporta todos os tipos de dados VHAL, grupos de propriedades e configurações
Integra-se com ferramentas de geração de código existentes para implementação completa

Instalação

Pré-requisitos

Python 3.12 ou superior
Conexão com a internet para raspagem de documentação
Cliente compatível com MCP (Claude Desktop, Zed ou outros clientes MCP)

Configuração Local

Clone o repositório

Usando HTTPS:

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

Usando SSH:

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

Navegue até o diretório do projeto
```
cd vhal-mcp-server
```
Instale as dependências
```
pip install -e .
```

Configuração do Cliente MCP

Configuração do Claude Desktop

Encontre o caminho de instalação do uv
```
which uv
```
Localize o arquivo de configuração do Claude Desktop
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%/Claude/claude_desktop_config.json

Adicione a configuração do servidor

Edite o arquivo de configuração e adicione o seguinte (substitua os caminhos pelos seus caminhos reais):

{
  "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"
            }
         }
      }
   }

Você pode encontrar um exemplo na pasta de configuração.

Importante:

Substitua /path/to/your/uv pela saída do passo 1 (ex.: /Users/yourusername/.local/bin/uv)
Substitua /path/to/vhal-mcp-server pelo caminho real onde você clonou o repositório
No macOS, aplicativos GUI como Claude Desktop podem não ter acesso ao PATH do seu shell, portanto, usar caminhos completos é necessário

Reinicie o Claude Desktop

Após salvar o arquivo de configuração, saia completamente e reinicie o Claude Desktop para que o servidor MCP seja carregado.
Permita o acesso ao servidor MCP

Quando você fizer sua primeira pergunta que exija as ferramentas vHAL, o Claude solicitará que você permita que o servidor MCP use suas ferramentas. Clique em "Permitir" para habilitar os recursos de análise vHAL.

Uso

Uso Básico

O servidor expõe ferramentas MCP que podem ser usadas através de clientes compatíveis. Cada ferramenta aceita parâmetros específicos e retorna informações estruturadas sobre propriedades vHAL e implementações.

Exemplos de Prompts para Iniciantes

Comece com estes prompts simples para explorar os recursos vHAL:

Descoberta Básica de Propriedades

Show me all HVAC-related properties and their IDs

Perguntas Simples de Implementação

How do I control the fan speed in Android Automotive?

Consulta de Propriedade

Find Android source code for seat heating properties

Controle Básico de Temperatura

What properties do I need to set the cabin temperature?

Entendendo Tipos de Propriedades

Explain the HVAC_POWER_ON property and how to use it

Exemplos de Prompts Avançados

Depois de se familiarizar com os conceitos básicos, tente estes prompts abrangentes:

Implementação Completa de 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.

Controle Climático Multi-Zona

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 Memória de Assento

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.

Recursos Críticos de Segurança

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.

Otimização de Desempenho

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.

Desenvolvimento de Propriedade Personalizada

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

Exemplos de Geração de Código VHAL

Use a ferramenta generate_vhal_implementation_code para criar implementações VHAL completas:

Sistema Inteligente de Iluminação do Painel

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.

Gerenciamento de Carregamento de Veículos Elétricos

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.

Controle Avançado 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 Assento

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.

Exemplos de Geração de Pull Request VHAL

Use a ferramenta generate_vhal_pr_message para criar mensagens profissionais de pull request:

PR de Iluminação Inteligente do Painel

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 de Sistema de Carregamento VE

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 Controle Avançado 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.

Exemplos de Validação de Propriedades VHAL

Use a ferramenta validate_vhal_property_request para seguir as melhores práticas Android e validar solicitações de propriedades:

Verificar Propriedades 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 Propriedades de Controle Climático

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.

Validação de Recurso Personalizado de Veí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.

Validação Avançada de Propriedades

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.

Validação de Tipos de Propriedades

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.

Prompt Especialista: Desenvolvimento Completo de Sistema VHAL

Este prompt de nível especialista demonstra o uso de todas as 6 ferramentas MCP em um fluxo de trabalho abrangente para desenvolver um sistema automotivo 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.

Recursos do Gerador de Código VHAL

A ferramenta generate_vhal_implementation_code cria implementações VHAL completas e prontas para produção:

Arquivos Gerados

Para cada propriedade VHAL, o gerador cria:

Arquivos HAL Principais:

types.hal - Definição de propriedade e enums
DefaultConfig.h - Configuração de propriedade
EmulatedVehicleHal.cpp - Lógica de implementação
VehicleProperty.aidl - Interface AIDL

Integração com Framework:

VehiclePropertyIds.java - Constantes Java
CarPropertyManager.java - Métodos de API
Arquivos JSON de configuração

Testes:

VehicleHalTest.cpp - Testes unitários C++
VehiclePropertyTest.java - Testes de integração Java

Configuração do Sistema:

Regras SEPolicy
Configurações de build
Documentação

Parâmetros da Ferramenta

Obrigatórios:

name: Nome da propriedade (ex.: "HVAC_STEERING_WHEEL_HEAT")
property_id: ID único da propriedade (formato hexadecimal, ex.: "0x15400A03")
property_type: Tipo de dados (BOOLEAN, INT32, INT64, FLOAT, STRING, BYTES, *_VEC, MIXED)
group: Grupo de propriedade (HVAC, SEAT, LIGHTS, POWER, CLIMATE, etc.)
access: Modo de acesso (READ, WRITE, READ_WRITE)
change_mode: Modo de alteração (STATIC, ON_CHANGE, CONTINUOUS)
description: Descrição da propriedade para documentação

Opcionais:

units: Unidades (ex.: "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 do veículo
enum_values: Dicionário de nomes e valores de enum para propriedades enum INT32
dependencies: Lista de nomes de propriedades dependentes
sample_rate_hz: Taxa de amostragem para propriedades contínuas

Tipos de Propriedades Suportados

Tipos Básicos:

BOOLEAN: Valores verdadeiro/falso
INT32: Inteiros de 32 bits
INT64: Inteiros de 64 bits
FLOAT: Números de ponto flutuante
STRING: Valores de texto
BYTES: Dados binários

Tipos Vetoriais:

INT32_VEC: Arrays de inteiros
FLOAT_VEC: Arrays de floats
STRING_VEC: Arrays de strings
BYTES_VEC: Arrays de dados binários

Tipos Especiais:

MIXED: Dados estruturados complexos

Grupos de Propriedades

BODY: Sistemas de controle de carroceria
CABIN: Controles internos da cabine
CLIMATE: Sistemas de controle climático
DISPLAY: Display e infotainment
ENGINE: Gerenciamento do motor
HVAC: Aquecimento, ventilação e ar condicionado
INFO: Informações do veículo
INSTRUMENT_CLUSTER: Instrumentos do painel
LIGHTS: Sistemas de iluminação
MIRROR: Controles de espelhos
POWER: Gerenciamento de energia
SEAT: Controles de assento
VEHICLE_MAP_SERVICE: Serviços de navegação
WINDOW: Controles de janelas
VENDOR: Propriedades específicas do fornecedor

Saída Gerada

Quando você usa o gerador de código, ele produz:

Resumo Completo - Configuração e visão geral da propriedade
Arquivos Gerados - Todos os 10+ arquivos de implementação necessários com realce de sintaxe
Guia de Implementação - Instruções de integração passo a passo
Exemplos de Uso - Código de exemplo para usar a propriedade
Comandos de Build - Comandos de build e teste AAOS

Casos de Uso

Desenvolvimento de Sistema de Controle Climático

Implemente sistemas HVAC abrangentes com relacionamentos adequados de propriedades:

Controle de Temperatura: Aquecimento e resfriamento multi-zona
Gerenciamento de Ventilador: Controle de velocidade e direção com feedback
Ar Condicionado: Controle do compressor AC e recirculação
Aquecimento Auxiliar: Aquecedores de assento, volante e espelhos
Recursos de Segurança: Capacidades de desembaçamento e degelo

Sistemas de Controle de Assento

Desenvolva recursos avançados de controle de assento:

Sistemas de Memória: Armazenamento e recall de posição
Recursos de Conforto: Funções de aquecimento, resfriamento e massagem
Controle de Movimento: Posicionamento e ajuste multi-eixo
Integração de Segurança: Detecção de ocupação e coordenação com airbags

Descoberta e Análise de Propriedades

Entenda ecossistemas de propriedades vHAL:

Mapeamento de Dependências: Identifique relacionamentos entre propriedades
Planejamento de Implementação: Obtenha orientação de desenvolvimento passo a passo
Análise de Código-Fonte: Acesse implementações Android reais
Melhores Práticas: Aprenda com padrões de propriedades existentes

Configuração

Integração com Cliente MCP

Para usar com clientes compatíveis com MCP, configure o endpoint do servidor e garanta o registro adequado das ferramentas. O servidor descobre e expõe automaticamente todas as ferramentas de análise vHAL disponíveis.

Otimização de Desempenho

O servidor usa mecanismos de raspagem paralela e cache para desempenho ideal:

Raspagem Paralela de Documentação: Busca concorrente de documentação Android
Cache do Banco de Dados de Propriedades: Armazenamento em memória de propriedades acessadas com frequência
Cache de Análise de Código-Fonte: Operações de análise repetidas otimizadas

Desenvolvimento

Estrutura do Projeto

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

Testes

Execute a suíte de testes:

python -m pytest test_vhal.py -v

Contribuindo

Faça um fork do repositório
Crie um branch de recurso
Implemente suas alterações com testes
Envie um pull request

Requisitos

mcp[cli] >= 1.10.1 - Implementação do Model Context Protocol
requests >= 2.31.0 - Cliente HTTP para extração de documentação
beautifulsoup4 >= 4.12.0 - Análise de HTML para documentação
lxml >= 4.9.0 - Processamento de XML/HTML

Licença

Este projeto é licenciado sob a Licença MIT. Consulte o arquivo LICENSE para obter detalhes.

Suporte

Para perguntas, problemas ou contribuições:

Repositório: https://github.com/feevlic/vhal-mcp-server
Problemas: https://github.com/feevlic/vhal-mcp-server/issues
Documentação: Consulte a documentação do Android vHAL em https://source.android.com/docs/automotive/vhal