🚀 OpenDSS MCP 服务器
本项目借助 Model Context Protocol (MCP) 框架搭建了 OpenDSS 服务器，能让电力系统仿真工具通过 MCP 协议与大型语言模型 (LLM) 实现交互，为电力系统分析和操作提供便利。
🚀 快速开始
启动服务器
# 开发模式运行，带调试界面
mcp dev -m opendss_mcp.server
# 安装到Claude桌面版
mcp install -m opendss_mcp.server
基本用法示例
from mcp.server.fastmcp import FastMCP
from opendss_mcp.models.opendss import OpenDSSModel
# 创建一个OpenDSS MCP服务器
mcp = FastMCP("OpenDSS服务器")
# 编译DSS文件
@mcp.tool()
def compile_dss_file(file_path: str) -> dict:
"""编译DSS文件"""
model = OpenDSSModel()
return model.compile_dss_file(file_path)
✨ 主要特性
- 支持 OpenDSS 电力系统仿真核心功能。
- 通过 MCP 协议暴露 OpenDSS 的功能和数据。
- 提供易用的资源、工具和提示模板。
- 支持电力系统分析和操作的常见任务。
工具
compile_dss_file：编译 DSS 文件。execute_command：执行 OpenDSS 命令。solve：求解电力系统。get_power_flow：获取功率潮流结果。get_voltages：获取电压信息。get_losses：获取损耗信息。
资源
circuit://current：获取当前电路信息。elements://{type}：获取指定类型的元素信息。buses://list：获取所有母线列表。results://{result_type}：获取指定类型的结果数据。
提示模板
analyze_circuit：分析电路提示模板。solve_power_flow：求解功率潮流提示模板。explain_results：解释结果提示模板。
📦 安装指南
前提条件
- Python 3.10 或更高版本。
- OpenDSS 安装（通过 opendssdirect.py）。
安装步骤
使用 uv 安装（推荐）：
uv install git+https://github.com/your-username/opendss-mcp.git
或者使用 pip 安装：
pip install git+https://github.com/your-username/opendss-mcp.git
🤝 贡献
欢迎提交问题报告和贡献代码。请确保提交的代码符合项目的编码规范。
📄 许可证
MIT