pip install git+https://github.com/4alvit/mcp-venus-os

git clone https://github.com/4alvit/mcp-venus-os
cd mcp-venus-os
uv sync

# D-Bus configuration
DBUS_BUS_TYPE=system
DBUS_SERVICE_NAME=com.victronenergy

# MQTT configuration
MQTT_HOST=localhost
MQTT_PORT=1883
MQTT_BASE_TOPIC=N/venus-os

# Safety configuration
SAFETY_REQUIRE_CONFIRMATION=true
SAFETY_MAX_CHARGE_CURRENT=100
SAFETY_MAX_DISCHARGE_CURRENT=100
SAFETY_MIN_SOC_LIMIT=10
SAFETY_MAX_SOC_LIMIT=100
SAFETY_ALLOWED_MODES=on,off,charger_only,inverter_only,eco

mcp-venus-os

uv run mcp-venus-os

{
  "mcpServers": {
    "venus-os": {
      "command": "uv",
      "args": ["--directory", "/path/to/mcp-venus-os", "run", "mcp-venus-os"],
      "env": {
        "DBUS_BUS_TYPE": "system",
        "MQTT_HOST": "localhost",
        "MQTT_PORT": "1883"
      }
    }
  }
}

┌─────────────┐     D-Bus      ┌──────────────┐
│   Venus OS  │ ◄─────────────► │  mcp-venus-os │
│  (Cerbo GX) │                 │   MCP Server  │
└─────────────┘                 └──────┬───────┘
                                        │
                              ┌─────────┴─────────┐
                              │                   │
                       ┌──────▼──────┐     ┌──────▼──────┐
                       │   D-Bus     │     │   MQTT      │
                       │   Client    │     │   Client    │
                       └─────────────┘     └─────────────┘
                                        │
                              ┌─────────▼─────────┐
                              │  FastMCP Tools    │
                              └─────────┬─────────┘
                                        │
                              ┌─────────▼─────────┐
                              │   Claude Desktop  │
                              └───────────────────┘

# Install dev dependencies
uv sync --dev

# Run linter
uv run ruff check src/

# Run type checker
uv run mypy src/

# Run tests
uv run pytest