OpenDSS MCP Server (jpsalamanca-co)

MCP serverCommunity

Twenty typed OpenDSS tools for power flow, violations, faults, Thevenin impedance, hosting capacity and QSTS runs. By jpsalamanca-co.

1 starsUpdated 6 weeks agoGitHub data from 5 Nov 2026

At a glance

Type: MCP server
Works with: OpenDSS
How it connects: Drives a running copy of the tool
Access: Can modify models
Tool versions: OpenDSS engine bundled with py-dss-interface; Python 3.10 or later
Operating systems: Windows, Linux
Needs a OpenDSS licence: No
Transport: Local (stdio)
AI clients documented: Claude Desktop, Claude Code
Licence: MIT
Language: Python

What it can do

Compiles a DSS file or script, then returns bus voltages, line flows, loads, losses and voltage or thermal violations against limits you pass.
Runs three-phase and single-line-to-ground faults at a bus or swept across buses, and returns positive- and zero-sequence Thevenin impedance.
Adds PV in steps until a voltage, thermal or convergence limit binds, and runs daily or yearly QSTS with the circuit's load shapes.
Every tool returns structured JSON or Markdown that includes the inputs, so numbers come from OpenDSS rather than the model.

Limitations

A single-commit project from September 2026; install is from source only.
The author notes that results are only as good as the model: a wrong source impedance still converges.

Install

git clone https://github.com/jpsalamanca-co/opendss-mcp.git
cd opendss-mcp
pip install -e ".[dev]"   # [dev] adds pytest, pytest-asyncio and ruff
python -m pytest tests -q

Source: github.com/jpsalamanca-co/opendss-mcp#installation

{
  "mcpServers": {
    "opendss_mcp": {
      "command": "opendss-mcp",
      "env": { "OPENDSS_MCP_OUTPUT_DIR": "./results" }
    }
  }
}

Source: github.com/jpsalamanca-co/opendss-mcp#client-configuration

MCP servers and skills run code on your computer. Review the source before installing.

AI-generated models, drawings and results must be checked by a qualified engineer before use.