EPW.tools
Tệp thời tiết và dữ liệu khí hậu cho mọi địa điểm và mọi năm: EPW, DDY và STAT của EnergyPlus cho các năm thực tế từ 1990, các năm điển hình và khí hậu tương lai đến năm 2100, cùng với điều kiện thiết kế, nhiệt độ Manual J và màn hình khí hậu. Bắt đầu miễn phí.
Máy chủ MCP được lưu trữ
npx add-mcp 'https://epw.tools/api/mcp'Cài vào Claude Code, Codex, Cursor và nhiều công cụ khác
Tài liệu
epwtools
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).