a month ago
An MCP (Model Context Protocol) server that connects to Victron Energy GX devices via Modbus TCP or MQTT on your local network. Get direct, low-latency access to real-time solar, battery, grid, and inverter data — no cloud required.
Built from the official CCGX Modbus TCP register list (Rev 50, 900+ registers across 33 device categories).
Features
30 specialized tools for reading Victron device data
Dual transport — Modbus TCP (port 502) or MQTT (port 1883)
900+ registers across 33 device categories
Network discovery — scan the local network to find GX devices, no IP needed
One-shot setup — victron_setup probes both transports, discovers everything, generates ready-to-use config
Read-only and safe — all tools annotated with readOnlyHint: true
Server Config
{
"mcpServers": {
"victron-tcp": {
"command": "npx",
"args": [
"-y",
"victron-tcp"
],
"env": {
"VICTRON_HOST": "192.168.1.50",
"VICTRON_TRANSPORT": "mqtt",
"VICTRON_PORTAL_ID": "your-portal-id"
}
}
}
}