LMC-mcp-server

LMC-mcp-server

0

OpenDSS MCP Server is a tool for integrating power system simulations with large language models via the MCP protocol. It provides core functionalities of OpenDSS and user-friendly resources for power system analysis. The server is easy to install and supports a variety of common power system tasks.

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