OpenDSS MCP 服务器

这个项目是使用Model Context Protocol (MCP)框架构建的OpenDSS服务器。它使电力系统仿真工具可以通过MCP协议与大型语言模型(LLM)进行交互。

功能特点

• 支持OpenDSS电力系统仿真核心功能
• 通过MCP协议暴露OpenDSS的功能和数据
• 提供易用的资源、工具和提示模板
• 支持电力系统分析和操作的常见任务

安装

前提条件

• 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

快速开始

启动服务器

# 开发模式运行，带调试界面
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)

主要功能

工具

• 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: 解释结果提示模板

贡献

欢迎提交问题报告和贡献代码。请确保提交的代码符合项目的编码规范。

许可证

MIT