Metadata-Version: 2.4
Name: wican-blade-mcp
Version: 0.2.0
Summary: Universal vehicle monitoring via meatPi WiCAN Pro OBD-II adapter — standard PIDs over MQTT, raw CAN bus decoding, and diagnostic trouble codes.
Author: Groupthink Dev
License-Expression: MIT
Keywords: can-bus,mcp,mqtt,obd2,vehicle,wican
Classifier: Development Status :: 3 - Alpha
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: MIT License
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Interface Engine/Protocol Translator
Requires-Python: >=3.12
Requires-Dist: cantools>=39.0.0
Requires-Dist: fastmcp>=2.0.0
Requires-Dist: paho-mqtt>=2.0.0
Requires-Dist: pydantic>=2.0.0
Description-Content-Type: text/markdown

# wican-blade-mcp

Universal vehicle monitoring via [meatPi WiCAN Pro](https://www.meatpi.com/products/wican-pro) OBD-II adapter. Standard PIDs over MQTT, raw CAN bus decoding, diagnostic trouble codes, and trip data. Works with any OBD-II vehicle.

## Install

```bash
uv tool install wican-blade-mcp
```

## Configuration

| Variable | Required | Description |
|----------|----------|-------------|
| `MQTT_BROKER` | Yes | MQTT broker hostname or IP |
| `MQTT_PORT` | No | Broker port (default: 1883) |
| `MQTT_USERNAME` | No | Broker username |
| `MQTT_PASSWORD` | No | Broker password |
| `WICAN_DEVICE_ID` | No | Device ID (auto-discovered if omitted) |
| `WICAN_DBC_PATH` | No | Path to opendbc DBC file for CAN decoding |
| `WICAN_WRITE_ENABLED` | No | Enable DTC clearing and raw CAN send |

## Tools

| Tool | Type | Description |
|------|------|-------------|
| `wican_vehicles` | read | Device connection status and vehicle identity |
| `wican_state` | read | Speed, RPM, fuel, coolant, battery, throttle, load |
| `wican_diagnostics` | read | DTCs, MIL status, monitor readiness |
| `wican_battery` | read | Battery voltage, EV SoC (if CAN-decoded) |
| `wican_trip` | read | Speed, RPM, run time, odometer, fuel level |
| `wican_can_read` | read | Raw CAN frames from buffer |
| `wican_dtc_clear` | gated | Clear DTCs and reset MIL |
| `wican_can_send` | gated | Send raw CAN frame |

## License

MIT
