LMC MCP Server

🚀 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