LE

lbnl-eta/energyplus-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

126 stars 25 forks Качество 81 Тренд 36NOASSERTION

lbnl-eta/energyplus-mcp — это кандидат на сервер MCP, импортированный из https://github.com/lbnl-eta/energyplus-mcp.

Обзор

lbnl-eta/energyplus-mcp — это кандидат на сервер MCP, импортированный из https://github.com/lbnl-eta/energyplus-mcp.

Обзор (машинный перевод)

Сервер Model Context Protocol (MCP), предоставляющий 35 комплексных инструментов для работы с моделями симуляции энергии EnergyPlus зданий. Этот сервер позволяет ассистентам ИИ и другим клиентам MCP загружать, проверять, изменять и анализировать файлы IDF EnergyPlus через стандартизированный интерфейс.

Версия: 0.1.0 Совместимость с EnergyPlus: 26.1.0 (по умолчанию; см. Строительство против другой версии EnergyPlus) Python: 3.10+

📑 Содержание

  • Обзор
  • Установка
  • Использование сервера MCP
  • Claude Desktop
  • Код VS
  • Курсор
  • Настройка разработки
  • Контейнер разработки кода VS
  • Docker Setup
  • Местное развитие
  • Потоковый HTTP-транспорт (локальное тестирование)
  • Строительство на фоне другой версии EnergyPlus
  • Доступные инструменты
  • Примеры использования
  • Архитектура
  • Конфигурация
  • Устранение неисправностей
  • Вклад
  • Процитировать это произведение
  • Лицензия

Обзор

EnergyPlus MCP Server делает симуляцию энергии зданий EnergyPlus доступной для AI-ассистентов и инструментов автоматизации через протокол Model Context Protocol.

Ключевые особенности:

  • 🏗️ Полный жизненный цикл модели: загрузка, проверка, анализ, модификация и симуляция файлов IDF

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

EnergyPlus MCP Server

A Model Context Protocol (MCP) server that provides 35 comprehensive tools for working with EnergyPlus building energy simulation models. This server enables AI assistants and other MCP clients to load, validate, modify, and analyze EnergyPlus IDF files through a standardized interface.

Version: 0.1.0
EnergyPlus Compatibility: 26.1.0 (default; see Building against a different EnergyPlus version)
Python: 3.10+

Overview

EnergyPlus MCP Server makes EnergyPlus building energy simulation accessible to AI assistants and automation tools through the Model Context Protocol.

Key Features:

  • 🏗️ Complete Model Lifecycle: Load, validate, analyze, modify, and simulate IDF files
  • 🔍 Deep Building Analysis: Extract detailed information about zones, surfaces, materials, and schedules
  • 🚀 Automated Simulation: Execute EnergyPlus simulations with weather files
  • 📊 Advanced Visualization: Create interactive plots and HVAC system diagrams
  • 🔧 HVAC Intelligence: Discover, analyze, and visualize HVAC system topology
  • 📈 Smart Output Management: Auto-discover and configure output variables/meters

Installation

Using the MCP Server

Prerequisites (all clients):

  • Docker Desktop (macOS / Windows) or Docker Engine (Linux), running
  • git on your PATH
  • The energyplus-mcp-dev image built locally (step 1 below — do this once)

Choose the appropriate setup for your AI assistant or IDE:

Claude Desktop

  1. Build the Docker image (one-time setup):

    git clone https://github.com/LBNL-ETA/EnergyPlus-MCP.git
    cd EnergyPlus-MCP
    docker build -t energyplus-mcp-dev -f .devcontainer/Dockerfile .devcontainer
    
  2. Locate the Claude Desktop config file for your OS:

    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
Открыть полный README на GitHub

Установка

docker run // Docker subcommand to run a container "--rm // Remove container after it exits (cleanup) "-i // Interactive mode for stdio communication "-v /path/to/EnergyPlus-MCP:/workspace // Mount local dir to container "-w /workspace/energyplus-mcp-server // Working dir in container "energyplus-mcp-dev // Docker image name we built "uv run python -m energyplus_mcp_server.server" // Server startup command
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "energyplus": { // Server name shown in Claude Desktop "command": "docker", // Main command to execute "args": [ "run", // Docker subcommand to run a container "--rm", // Remove container after it exits (cleanup) "-i", // Interactive mode for stdio communication "-v", "/path/to/EnergyPlus-MCP:/workspace", // Mount local dir to container "-w", "/workspace/energyplus-mcp-server", // Working dir in container "energyplus-mcp-dev", // Docker image name we built "uv", "run", "python", "-m", "energyplus_mcp_server.server" // Server startup command ] } } }