📅 发布时间：2026/6/21 16:58:09

vscode+energyplus+EnergyPlus-MCP工作流

EnergyPlus-MCP，是首个专为 EnergyPlus 模拟工作流程设计的开源模型上下文协议 (MCP) 服务器，为人工智能驱动的建筑能耗建模构建了新的基础架构。

EnergyPlus-MCP (https://www.sciencedirect.com/science/article/pii/S2352711025003334?via%3Dihub)

GitHub - LBNL-ETA/EnergyPlus-MCP: The first open-source Model Context Protocol server enabling AI assistants and applications to interact programmatically with EnergyPlus building energy simulation. 在GitHub上面的说明有些老旧，我做出了重新更新。系统win11

与VS Code中cline联动

构建 Docker 镜像 ( 需要dockerDesktop在后台运行)

容器会自动安装 EnergyPlus 25.1.0 及其所有依赖项

git clone https://github.com/LBNL-ETA/EnergyPlus-MCP.git
cd EnergyPlus-MCP/.devcontainer
docker build -t energyplus-mcp-dev .

配置Cline：

添加到.vscode/settings.json您的项目中：

{"mcp.servers": {
"energyplus": {"command": "docker","args": ["run","--rm","-i","-v", "C:/Users/k/Documents/Git/GIt_progress/EnergyPlus-MCP:/workspace","-w",  "/workspace/energyplus-mcp-server","energyplus-mcp-dev","uv",        "run",        "python","-m",        "energyplus_mcp_server.server"]}}}
}

重要提示//：添加到实际配置文件时，请删除所有注释（括号后的文本）

请重启 VS Code以使更改生效。

可以提供功能

可用工具

服务器提供35 种工具，分为5 个类别：

🗂️ 模型配置与加载（9 种工具）

load_idf_model- 加载并验证IDF文件
validate_idf- 全面的模型验证
list_available_files- 浏览示例文件和天气数据
copy_file- 智能文件复制，支持路径解析
get_model_summary- 提取基本模型信息
check_simulation_settings- 查看仿真控制设置
modify_simulation_control- 修改仿真参数
modify_run_period- 调整模拟时间段
get_server_configuration获取服务器配置信息

🔍 模型检查（9 种工具）

list_zones- 列出所有热区及其属性
get_surfaces获取建筑物表面信息
get_materials- 提取材料定义
inspect_schedules- 分析所有日程对象
inspect_people- 分析入住率设置
inspect_lights- 分析照明负荷
inspect_electric_equipment- 分析设备负载
get_output_variables- 获取/发现输出变量
get_output_meters- 获取/了解能源表

⚙️ 模型修改（8 种工具）

modify_people- 更新入住设置
modify_lights- 更新照明负荷
modify_electric_equipment- 更新设备负载
change_infiltration_by_mult- 调整渗透率
add_window_film_outside- 添加窗膜
add_coating_outside- 涂覆表面涂层
add_output_variables- 添加输出变量
add_output_meters- 添加电能表

🚀 模拟与结果（4 种工具）

run_energyplus_simulation- 执行模拟
create_interactive_plot- 生成 HTML 可视化图表
discover_hvac_loops查找所有暖通空调回路
get_loop_topology获取暖通空调回路详情

🖥️ 服务器管理（5 种工具）

visualize_loop_diagram- 生成暖通空调（HVAC）图纸
get_server_status- 检查服务器健康状况
get_server_logs- 查看最近的日志
get_error_logs获取错误日志
clear_logs- 清除/轮换日志文件

助力科研|EnergyPlus-MCP与vscode的联动