Mcp Server For Victron Energy Gx Devices

Name: Mcp Server For Victron Energy Gx Devices
Author: lubosstrejcek

@lubosstrejcek

Repository

About Mcp Server For Victron Energy Gx Devices

No overview available yet

#victron

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "victron-tcp": {
      "command": "npx",
      "args": [
        "victron-tcp"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Mcp Server For Victron Energy Gx Devices?

An MCP server that connects to Victron Energy GX devices on a local network via MQTT or Modbus TCP, providing direct, low-latency access to real-time solar, battery, grid, and inverter data — no cloud required. It covers 900+ registers across 33 device categories, built from the official CCGX Modbus TCP register list (Rev 50).

How to use Mcp Server For Victron Energy Gx Devices?

Install with npx victron-tcp and configure via environment variables VICTRON_HOST, VICTRON_TRANSPORT, and VICTRON_PORTAL_ID. Use with Claude Code (claude mcp add --transport stdio victron-tcp -- npx victron-tcp) or add to Claude Desktop / Cursor / Windsurf MCP config. The AI can also run victron_network_scan and victron_setup to auto-discover devices.

Key features of Mcp Server For Victron Energy Gx Devices

30 specialized tools for reading Victron device data
Dual transport — MQTT (zero-config) or Modbus TCP
Network discovery to find GX devices without an IP
One-shot setup probing both transports and generating config
Read-only and safe with readOnlyHint: true

Use cases of Mcp Server For Victron Energy Gx Devices

Monitor solar PV power, yield, and charger state
Check battery SOC, voltage, current, temperature, and time-to-go
View grid power per phase and inverter/charger status
Read tank levels, temperature sensors, and EV charging station data
Discover and configure Victron devices on the local network

FAQ from Mcp Server For Victron Energy Gx Devices

Does this server require a cloud connection?

No, it connects directly to Victron GX devices on the local network via MQTT or Modbus TCP.

What are the prerequisites?

A Victron GX device (Ekrano, Cerbo, Venus GX, etc.) on the local network, MQTT or Modbus TCP enabled in device settings, and Node.js 18+.

Which transports are supported and how do they differ?

MQTT (port 1883, zero-config with Venus OS built-in broker) and Modbus TCP (port 502, raw register access). MQTT is recommended.

Is the server read-only?

Yes, all tools are annotated with readOnlyHint: true. Write support (ESS mode control, grid setpoint) is planned for Phase 2.

How do I find my GX device IP if I don't know it?

Use the victron_network_scan tool to scan the local network by probing Modbus TCP and MQTT ports, then victron_setup to configure everything.

Comments

More Other MCP servers

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K