Thanks to visit codestin.com
Credit goes to github.com

Skip to content

PowerMCP is an open-source collection of MCP servers for power system software like PowerWorld and OpenDSS. These tools enable LLMs to directly interact with power system applications, facilitating intelligent coordination, simulation, and control in the energy domain.

License

Power-Agent/PowerMCP

Repository files navigation

PowerMCP ⚡

License: MIT Python Version

PowerMCP is an open-source collection of MCP servers for power system software like PowerWorld and OpenDSS. These tools enable LLMs to directly interact with power system applications, facilitating intelligent coordination, simulation, and control in the energy domain.

🌟 What is MCP?

The Model Context Protocol (MCP) is a revolutionary standard that enables AI applications to seamlessly connect with various external tools. Think of MCP as a universal adapter for AI applications, similar to what USB-C is for physical devices. It provides:

  • Standardized connections to power system software and data sources
  • Secure and efficient data exchange between AI agents and power systems
  • Reusable components for building intelligent power system applications
  • Interoperability between different AI models and power system tools

🤝 Our Community Vision

We're building an open-source community focused on accelerating AI adoption in the power domain through MCP. Our goals are:

  • Collaboration: Bring together power system experts, AI researchers, and software developers
  • Innovation: Create and share MCP servers for various power system software and tools
  • Education: Provide resources and examples for implementing AI in power systems
  • Standardization: Develop best practices for AI integration in the energy sector

🚀 Getting Started with MCP

📖 Quick Tutorial

🚀 New to PowerMCP? Start here!

📋 PowerMCP Tutorial PDF - Your complete guide to getting started with PowerMCP

This comprehensive tutorial will walk you through everything you need to know to begin using PowerMCP effectively.

Easy Fully Offline Quick Start - No API Keys

Using commericial AI models in Claude Desktop or Cursor.ai is great, but if your company security policies dictate, you can run these models fully offline and keep your confidential power flow information private, away from prying eyes.

Ollama setup for local AI model
  1. Install Ollama from https://ollama.com/download/windows

  2. From the model dropdown box, download a tool-capable AI model like GPT-oss or qwen3

You might have trouble downloading the models from online through Ollama. You can copy the models from another machine if you zip your %USERPROFILE%/.ollama/models folder and bring it from a machine that has network access to HuggingFace.

  1. Serve the model by enabling the option in Ollama settings or by running ollama serve
MCPHost for local MCP protocol handling
  1. Install the GO programming language from https://go.dev/dl

  2. Clone the MCPHost program from Github using

go install github.com/mark3labs/mcphost@latest
  1. Setup your config.json file Open your config.json file in a text editor. In the JSON list of tools, add the Powerflow programs you have installed on your computer. For example, PSLF
{
  "mcpServers": {
    "pslf": {
      "command": "python",
      "args": ["PSLF/pslf_mcp.py"]
    }
  }
}

Or for PowerWorld.

{
  "mcpServers": {
    "powerworld": {
      "command": "python",
      "args": ["PowerWorld/powerworld_mcp.py"]
    }
  }
}
  1. Start the MCP server, replacing the model name and config file with your preferred option.
mcphost -m ollama:qwen3:4b --config .\config.json

Video Demos

Check out these demos showcasing PowerMCP in action:

  • Contingency Evaluation Demo: An LLM automatically operates power system software, such as PowerWorld and pandapower, to perform contingency analysis and generate professional reports.

  • Loadgrowth Evaluation Demo: An LLM automatically operates power system software, such as PowerWorld, to evaluate different load growth scenarios and generate professional reports with recommendations.

Useful MCP Tutorials

MCP follows a client-server architecture where:

  • Hosts are LLM applications (like Claude Desktop or IDEs) that initiate connections
  • Clients maintain 1:1 connections with servers, inside the host application
  • Servers provide context, tools, and prompts to clients

Check out these helpful tutorials to get started with MCP:

Using with LLMs

To use these MCP tools with an LLM:

  1. Install the MCP Python SDK:
pip install mcp-server-git
  1. Run your MCP server:
python your_server.py
  1. Configure your LLM application (e.g., Claude Desktop, Cursor) to use the MCP server:
{
  "mcpServers": {
    "servername": {
      "command": "python",
      "args": ["your_server.py"]
    }
  }
}

For instance, for pandapower you could configure the server as follows:

{
  "mcpServers": {
    "pandapower": {
      "command": "python",
      "args": ["pandapower/panda_mcp.py"]
    }
  }
}

📚 Documentation

For detailed documentation about MCP, please visit:

🤝 Contributing

We welcome contributions! Please see our Contributing Guidelines for details.

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

Core Team

Special Thanks

About

PowerMCP is an open-source collection of MCP servers for power system software like PowerWorld and OpenDSS. These tools enable LLMs to directly interact with power system applications, facilitating intelligent coordination, simulation, and control in the energy domain.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •