vHAL MCP Server is an MCP server that provides tools for exploring, searching, and implementing Android Vehicle Hardware Abstraction Layer (vHAL) documentation and source code. Built for Android Automotive OS (AAOS) engineers and embedded developers, it connects MCP-compatible clients to local and online Android automotive source references. The server enables users to discover vHAL properties, inspect hardware definitions across categories like HVAC and seating, and trace functional dependencies. It also assists in code creation by generating HAL definitions, Java APIs, unit tests, and build configurations for custom and standard properties. Additionally, the server validates property requests against Android 16 standards to prevent duplicate implementations, evaluates documentation source reliability with accessibility checks, and prepares formatted pull request messages complete with testing checklists and technical summaries.
Category: Cloud & Infrastructure
Tags: android, automotive, documentation, source-code, vhal
Follow these steps to set up the vHAL MCP Server with Claude Desktop: 1. Ensure Python 3.12 or higher and uv are installed on your system. 2. Clone the repository locally: bash git clone https://github.com/feevlic/vhal-mcp-server.git cd vhal-mcp-server 3. Install dependencies in editable mode: bash pip install -e . 4. Find the absolute path to your uv binary using which uv. 5. Open your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%/Claude/claude_desktop_config.json on Windows). 6. Add vhal-mcp-server under the mcpServers section using the full paths to uv and the cloned repository directory: json { "mcpServers": { "vhal-mcp-server": { "command": "/path/to/uv", "args": ["run", "--directory", "/path/to/vhal-mcp-server", "python", "main.py"], "env": { "PYTHONPATH": "/path/to/vhal-mcp-server" } } } } 7. Restart Claude Desktop and grant permission when prompted.
Part of MCP Servers
vHAL MCP Server is an interface that allows AI assistants like Claude to query Android Vehicle Hardware Abstraction Layer documentation and source code. It assists developers in analyzing vHAL properties, validating property requests, and generating boilerplate code for automotive components.
You can install it by cloning the GitHub repository, running pip install -e . in Python 3.12, and registering the server entry inside your Claude Desktop JSON configuration using uv and python main.py.
The server works with any MCP-compatible client that supports standard Model Context Protocol tool calling, including Claude Desktop and the Zed editor, provided the client can launch the local Python process.
The server provides tools to summarize vHAL concepts, look up Android source code by property, discover related dependencies, generate full HAL and Java implementation code, create pull request messages, and validate properties against Android releases.