Ermöglicht es AI-Clients, EnergyPlus-Wetterdateien, typische Jahre, zukünftige Klimaszenarien und Designbedingungen für jeden Ort auf der Erde zu generieren.
Auch bekannt als carlobianchi89/epwtools-python, epwtools-python, epwtools
- Stars
- 0
- Tools
- —
- Downloads, 30 Tage
- 191
- Neueste Version
- 0.5.3
- Letzter Commit
- 8. Nov. 2026
- Lizenz
- MIT
Was ist EPW.tools MCP?
EPW.tools ist ein MCP server. Ermöglicht es AI-Clients, EnergyPlus-Wetterdateien, typische Jahre, zukünftige Klimaszenarien und Designbedingungen für jeden Ort auf der Erde zu generieren.
Zusammenfassung generiert aus dem README des Projekts
Über EPW.tools MCP server
EPW.tools bietet einen MCP server, mit dem KI-Assistenten spezialisierte EnergyPlus-Wetterdateien für jeden Ort auf der Erde erstellen können. Dieses Tool wurde für Gebäude-Energiemodellierer und Forscher entwickelt, die präzise meteorologische Daten benötigen. Es fungiert als Remote-Service, der einen API-Key von der EPW.tools Website erfordert, um auf Daten zuzugreifen, die über die anfänglichen kostenlosen Dateien hinausgehen.
Nutzer können verschiedene Datentypen anfordern, darunter tatsächliche Jahre von 1990 bis heute, typische Jahre (TMY), Extrem- oder Hitzewellenjahre sowie zukünftige Klimaszenarien von 2030 bis 2100 unter SSP-Szenarien. Der Server stellt außerdem ASHRAE-Methoden-Designbedingungen und kurzfristige Forecast-Dateien bereit. Über spezifische Tools wie generate_epw, generate_tmy und generate_future_climate kann ein AI-Client die Erstellung von EPW, DDY-Design-Tagen und STAT-Zusammenfassungen für komplexe Simulations-Workflows automatisieren.
Was du damit machen kannst
- 1Historische Wetterdateien generierenFordere eine EnergyPlus-Wetterdatei für ein bestimmtes Jahr und bestimmte Koordinaten an, um die vergangene Gebäudeeffizienz zu simulieren.
- 2Zukünftige Klimaauswirkungen modellierenErstelle Wetterdateien für zukünftige Jahre unter Verwendung spezifischer SSP-Szenarien, um langfristige Klimaveränderungen zu untersuchen.
- 3ASHRAE-Designbedingungen abrufenRufe Design-Temperaturdaten unter Verwendung der ASHRAE-Methode für einen spezifischen Breitengrad und Längengrad ab.
- 4Typische meteorologische Jahre erstellenGeneriere eine TMY-Datei basierend auf einem spezifischen Bereich historischer Jahre für einen bestimmten Standort.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du EPW.tools MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenEPW.tools MCP in Claude Code installieren
$ claude mcp add --env 'EPWTOOLS_API_KEY=<YOUR_EPWTOOLS_API_KEY>' epwtools-python -- uvx epwtoolsEPW.tools MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"epwtools-python": {
"command": "uvx",
"args": [
"epwtools"
],
"env": {
"EPWTOOLS_API_KEY": "<YOUR_EPWTOOLS_API_KEY>"
}
}
}
}EPW.tools MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"epwtools-python": {
"type": "stdio",
"command": "uvx",
"args": [
"epwtools"
],
"env": {
"EPWTOOLS_API_KEY": "<YOUR_EPWTOOLS_API_KEY>"
}
}
}
}EPW.tools MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"epwtools-python","type":"stdio","command":"uvx","args":["epwtools"],"env":{"EPWTOOLS_API_KEY":"<YOUR_EPWTOOLS_API_KEY>"}}'EPW.tools MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"epwtools-python": {
"command": "uvx",
"args": [
"epwtools"
],
"env": {
"EPWTOOLS_API_KEY": "<YOUR_EPWTOOLS_API_KEY>"
}
}
}
}EPW.tools MCP in Codex installieren
$ codex mcp add epwtools-python --env 'EPWTOOLS_API_KEY=<YOUR_EPWTOOLS_API_KEY>' -- uvx epwtoolsEPW.tools MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.epwtools-python] command = "uvx" args = ["epwtools"] [mcp_servers.epwtools-python.env] EPWTOOLS_API_KEY = "<YOUR_EPWTOOLS_API_KEY>"
EPW.tools MCP in Gemini CLI installieren
$ gemini mcp add -s user -e 'EPWTOOLS_API_KEY=<YOUR_EPWTOOLS_API_KEY>' epwtools-python uvx -- epwtoolsEPW.tools MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"epwtools-python": {
"command": "uvx",
"args": [
"epwtools"
],
"env": {
"EPWTOOLS_API_KEY": "<YOUR_EPWTOOLS_API_KEY>"
}
}
}
}Konfiguration
EPWTOOLS_API_KEYErforderlichSecretYour EPW.tools API key (free credits on signup at https://epw.tools)
| Name | Beschreibung | Typ |
|---|---|---|
| EPWTOOLS_API_KEY | Your EPW.tools API key (free credits on signup at https://epw.tools) | ErforderlichSecret |
Automatisierte Checks
Geluften am 12. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSBestanden
- Destruktive Tools sind markiertNicht geprüft
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehenepwtools
Python client, command-line tool and MCP server for EPW.tools: EnergyPlus weather files (EPW, with DDY design days and STAT summaries) for any location on Earth.
- Actual years from 1990 to now, for any coordinates, with or without a nearby weather station
- Typical years (TMY), extreme and heatwave years
- Future climate for 2030 to 2100 under SSP scenarios
- Design conditions (ASHRAE method) and short-term forecast weather files
The weather data are built and validated by EPW.tools (methodology, validation); this package is the open-source way to call them from Python, the terminal or an AI assistant.
Install
pip install epwtools # client + CLI
pip install 'epwtools[mcp]' # + MCP server for AI assistants
Get a free API key at epw.tools (API tab); the first files are free.
export EPWTOOLS_API_KEY=your-key
Python
from epwtools import EPWClient
client = EPWClient() # reads EPWTOOLS_API_KEY
# actual year 2023 for a site in Denver
epw = client.generate(lat=39.74, lon=-104.99, year=2023, name="Denver", out_dir="weather")
# typical year built from 2005-2024
tmy = client.tmy(lat=45.46, lon=9.19, start=2005, end=2024, name="Milan", out_dir="weather")
# design conditions (ASHRAE method)
dc = client.design_conditions(lat=51.51, lon=-0.13)
Command line
epwtools configure # store your key
epwtools generate --lat 39.74 --lon -104.99 --year 2023 --name Denver
epwtools tmy --lat 45.46 --lon 9.19 --start 2005 --end 2024 --name Milan
epwtools future --lat 40.71 --lon -74.01 --scenario ssp245 --horizon 2050 --name NYC
epwtools --help
AI assistants (MCP)
Let Claude, ChatGPT and other MCP-capable assistants make weather files for you:
uvx --from 'epwtools[mcp]' epw-tools-mcp
or use the hosted server, listed in the official MCP Registry. Tools include generate_epw, generate_tmy,
generate_future_climate, generate_forecast, get_design_conditions and get_nearest_stations.
Setup guide: epw.tools/ai-weather-files.
Also on EPW.tools (web)
EPW to CSV / Excel converter · Manual J design temperatures by address · Construction weather days · Data-centre site climate · API licence for software vendors
Licence
The client, CLI and MCP server in this repository are MIT-licensed. Use of the EPW.tools service and its data is governed by the EPW.tools terms of service (linked in the footer of epw.tools).
EPW.tools MCP Fragen
Wie füge ich EPW.tools MCP zu Claude Code hinzu?
Führe claude mcp add --env 'EPWTOOLS_API_KEY=<YOUR_EPWTOOLS_API_KEY>' epwtools-python -- uvx epwtools in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich EPW.tools MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Unterstützt es zukünftige Klimaprojektionen?
Ja, es liefert zukünftige Klimadaten von 2030 bis 2100 unter verschiedenen SSP-Szenarien.
Wie starte ich mit dem MCP server?
Du kannst den Server mit uvx über den Befehl uvx --from 'epwtools[mcp]' epw-tools-mcp ausführen.