EPW.tools

io.github.carlobianchi89由 GitHub 账号 carlobianchi89 发布v0.5.3更新于 Nov 4, 2026

EnergyPlus weather files (EPW, DDY, STAT) and design conditions for any site, OpenStudio-MCP ready.

已验证Streamable HTTP可网页运行位置与生活数据与分析

概览

AI 生成的概览

EPW.tools 可为任意地点生成 EnergyPlus 气象文件（EPW、DDY、STAT）、设计条件和预报，用于建筑模拟。

可以做什么
  • 查询地点附近的气象站以及 ASHRAE 设计条件
  • 按 URL 分析公开 EPW 文件，给出统计摘要和数据警告
  • 启动实况年、典型年（TMY）、CMIP6 未来气候以及 1 至 15 天预报气象文件的生成任务
  • 列出可用于未来气候变形的 CMIP6 全球与区域模型
  • 查询任务状态并获取已完成文件的下载链接
适用场景
适合在协助建筑能耗模拟时使用：需要某地点的气象文件或设计条件，包括典型年、未来气候情景或短期预报，且希望不离开对话即可完成。
运行要求
可使用托管远程端点，或通过 uvx 从带 MCP 扩展的 epwtools 包在本地运行。生成类工具需要以 api_key 传入 EPWTOOLS_API_KEY；读取类工具免费且无需密钥。免费账户提供少量初始额度。
安装前请注意
生成类工具会消耗额度：每个文件 1 点，未来气候 3 点，街道级城市数据另加 2 点；预报文件 7 天内免费。API 密钥会传给服务器，下载链接中带有密钥，应视为机密。任务为异步执行，需要轮询结果。

安装

在 SourceWeft 中

  1. 打开 控制台中的 EPW.tools，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。 远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.github.carlobianchi89%2Fepwtools/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

{
  "mcpServers": {
    "epw-tools": {
      "type": "http",
      "url": "https://epw.tools/api/mcp"
    }
  }
}

README

epwtools

[carlobianchi89/epwtools-python MCP server]

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

bash
pip install epwtools            # client + CLIpip install 'epwtools[mcp]'     # + MCP server for AI assistants

Get a free API key at epw.tools (API tab); the first files are free.

bash
export EPWTOOLS_API_KEY=your-key

Python

python
from epwtools import EPWClient
client = EPWClient()                       # reads EPWTOOLS_API_KEY
# actual year 2023 for a site in Denverepw = client.generate(lat=39.74, lon=-104.99, year=2023, name="Denver", out_dir="weather")
# typical year built from 2005-2024tmy = 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

bash
epwtools configure                          # store your keyepwtools generate --lat 39.74 --lon -104.99 --year 2023 --name Denverepwtools tmy --lat 45.46 --lon 9.19 --start 2005 --end 2024 --name Milanepwtools future --lat 40.71 --lon -74.01 --scenario ssp245 --horizon 2050 --name NYCepwtools --help

AI assistants (MCP)

Let Claude, ChatGPT and other MCP-capable assistants make weather files for you:

bash
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).

来源：README.md，提交 f1e0fc9

工具

9

get_nearest_stations

Nearest weather stations

Nearest weather stations to a point (name, WMO id, distance, years of record). Free, no key.

输入参数nlat必填lon必填

get_design_conditions

Design conditions (ASHRAE method or EPW.tools Enhanced)

Heating and cooling design conditions for any site, free, in one of two modes that are never mixed. mode="ashrae_method": the ASHRAE Handbook Ch. 14 method replicated at the nearest ASHRAE station for the chosen edition (2025, 2021, 2017, 2013, 2009, 2005); validated about 0.25 degC from the published tables. mode="enhanced": EPW.tools Enhanced, not the ASHRAE method: values at the site itself for today's climate with a tested 90 % range. The DDY file for Enhanced costs 1 credit through the web or the API.

输入参数lat必填lon必填modeeditionlocation_namecurrent_climate

list_cmip6_models

CMIP6 models for future climate

The models available for future-climate morphing: `models` are global CMIP6 models (NASA NEX-GDDP, 25 km); `regional` are EURO-CORDEX pairs (12.5 km, Europe only, 27-72 N / 25 W-45 E) usable as `model` ids. Free.

无需输入参数。

analyze_epw

Analyze an EPW by URL

Summary statistics of any public EPW by URL (OneBuilding, EnergyPlus, a shared file): location header, dry-bulb mean/min/max, annual global horizontal irradiation, data range warnings. Free, no key. 10 MB max.

输入参数url必填

generate_epw

Generate actual-year EPW (AMY)

Start an actual-year (AMY) EPW + DDY + STAT for any point, 1990 to last year. 1 credit; +2 with urban_street_level (53 US cities: hourly street-level air temperature from citizen stations). Returns a job_id; poll with get_job_result.

输入参数lat必填lon必填year必填api_key必填dc_editiondata_sourcelocation_nameurban_street_level

generate_tmy

Generate typical year (TMY)

Start a typical meteorological year from a chosen period (at least 5 years; 10-20 is usual). 1 credit.

输入参数lat必填lon必填api_key必填end_year必填dc_editionstart_year必填location_name

generate_future_climate

Generate future-climate EPW (CMIP6)

Start a CMIP6-morphed future EPW (Belcher 2005). scenario: ssp126, ssp245, ssp370, ssp585; horizon: any decade 2030-2100; model from list_cmip6_models. 3 credits.

输入参数lat必填lon必填modelapi_key必填horizonscenariobase_yearlocation_name

generate_forecast

Generate forecast EPW

Start a forecast EPW for the next 1-15 days (operational sims, MPC, demand response). Up to 7 days free.

输入参数lat必填lon必填daysapi_key必填location_name

get_job_result

Job status and download links

Status of a job started by a generate_* tool; when complete, the download URLs (they carry the key).

输入参数job_id必填api_key必填

版本历史

4
  1. v0.5.3最新Nov 4, 2026
  2. v0.5.2Oct 26, 2026
  3. v0.5.1Oct 17, 2026
  4. v0.4.0Sep 29, 2026

评分

已满足适用检查项的 100%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通必需25 分
  • 已声明认证方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分