AI 클라이언트가 지구상의 모든 위치에 대해 EnergyPlus 기상 파일, 전형적 기상 연도(TMY), 미래 기후 시나리오 및 설계 조건을 생성할 수 있도록 지원합니다.
다른 이름 carlobianchi89/epwtools-python, epwtools-python, epwtools
- 스타
- 0
- Tools
- —
- 다운로드, 30일
- 191
- 최신 버전
- 0.5.3
- 마지막 커밋
- 2026년 11월 8일
- 라이선스
- MIT
EPW.tools MCP란?
AI 클라이언트가 지구상의 모든 위치에 대해 EnergyPlus 기상 파일, 전형적 기상 연도(TMY), 미래 기후 시나리오 및 설계 조건을 생성할 수 있도록 지원합니다.
프로젝트 README에서 생성된 요약
EPW.tools MCP server 정보
EPW.tools는 AI 어시스턴트가 지구상의 모든 위치에 대해 특화된 EnergyPlus 기상 파일을 생성할 수 있도록 하는 MCP server를 제공합니다. 이 도구는 정밀한 기상 데이터가 필요한 건물 에너지 모델러와 연구원을 위해 설계되었습니다. 초기 무료 파일 외의 데이터에 접근하려면 EPW.tools 웹사이트에서 발급받은 API key가 필요한 원격 서비스 방식으로 작동합니다.
사용자는 1990년부터 현재까지의 실제 연도, 전형적 기상 연도(TMY), 극한 또는 폭염 연도, 그리고 SSP 시나리오에 따른 2030년부터 2100년까지의 미래 기후 시나리오를 포함한 다양한 데이터 유형을 요청할 수 있습니다. 또한 서버는 ASHRAE 방식의 설계 조건과 단기 예보 파일도 제공합니다. generate_epw, generate_tmy, generate_future_climate와 같은 특정 도구를 통해 AI 클라이언트는 복잡한 시뮬레이션 워크플로우를 위한 EPW, DDY 설계일 및 STAT 요약 생성을 자동화할 수 있습니다.
활용 사례
- 1과거 기상 파일 생성특정 연도와 좌표의 EnergyPlus 기상 파일을 요청하여 과거 건물의 성능을 시뮬레이션합니다.
- 2미래 기후 영향 모델링특정 SSP 시나리오를 사용하여 미래 연도에 대한 기상 파일을 생성하고 장기적인 기후 변화를 연구합니다.
- 3ASHRAE 설계 조건 획득특정 위도와 경도에 대해 ASHRAE 방식을 사용하여 설계 온도 데이터를 가져옵니다.
- 4전형적 기상 연도 생성특정 위치에 대해 지정된 과거 연도 범위를 기반으로 TMY 파일을 생성합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
EPW.tools MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 EPW.tools MCP 설치
$ claude mcp add --env 'EPWTOOLS_API_KEY=<YOUR_EPWTOOLS_API_KEY>' epwtools-python -- uvx epwtoolsCursor에 EPW.tools MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"epwtools-python": {
"command": "uvx",
"args": [
"epwtools"
],
"env": {
"EPWTOOLS_API_KEY": "<YOUR_EPWTOOLS_API_KEY>"
}
}
}
}VS Code에 EPW.tools MCP 설치
.vscode/mcp.json
{
"servers": {
"epwtools-python": {
"type": "stdio",
"command": "uvx",
"args": [
"epwtools"
],
"env": {
"EPWTOOLS_API_KEY": "<YOUR_EPWTOOLS_API_KEY>"
}
}
}
}VS Code CLI에 EPW.tools MCP 설치
$ code --add-mcp '{"name":"epwtools-python","type":"stdio","command":"uvx","args":["epwtools"],"env":{"EPWTOOLS_API_KEY":"<YOUR_EPWTOOLS_API_KEY>"}}'Claude Desktop에 EPW.tools MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"epwtools-python": {
"command": "uvx",
"args": [
"epwtools"
],
"env": {
"EPWTOOLS_API_KEY": "<YOUR_EPWTOOLS_API_KEY>"
}
}
}
}Codex에 EPW.tools MCP 설치
$ codex mcp add epwtools-python --env 'EPWTOOLS_API_KEY=<YOUR_EPWTOOLS_API_KEY>' -- uvx epwtoolsCodex config.toml에 EPW.tools MCP 설치
~/.codex/config.toml
[mcp_servers.epwtools-python] command = "uvx" args = ["epwtools"] [mcp_servers.epwtools-python.env] EPWTOOLS_API_KEY = "<YOUR_EPWTOOLS_API_KEY>"
Gemini CLI에 EPW.tools MCP 설치
$ gemini mcp add -s user -e 'EPWTOOLS_API_KEY=<YOUR_EPWTOOLS_API_KEY>' epwtools-python uvx -- epwtoolsGemini settings.json에 EPW.tools MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"epwtools-python": {
"command": "uvx",
"args": [
"epwtools"
],
"env": {
"EPWTOOLS_API_KEY": "<YOUR_EPWTOOLS_API_KEY>"
}
}
}
}구성
EPWTOOLS_API_KEY필수비밀Your EPW.tools API key (free credits on signup at https://epw.tools)
| 이름 | 설명 | 유형 |
|---|---|---|
| EPWTOOLS_API_KEY | Your EPW.tools API key (free credits on signup at https://epw.tools) | 필수비밀 |
자동 검사
2026년 11월 12일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능통과
- 오픈 소스 라이선스 (OSI)통과
- 최근 1년 내 커밋 또는 릴리스통과
- 패키지 이름이 인기 패키지와 유사하지 않음통과
- 원격 엔드포인트가 HTTPS 사용통과
- 파괴적인 도구에 라벨 표시됨검사되지 않음
- 모델에 대한 숨겨진 지침 없음통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음통과
README
GitHub에서 보기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).
EPW.tools MCP 질문
EPW.tools MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add --env 'EPWTOOLS_API_KEY=<YOUR_EPWTOOLS_API_KEY>' epwtools-python -- uvx epwtools를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
EPW.tools MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
미래 기후 예측을 지원하나요?
네, 다양한 SSP 시나리오에 따라 2030년부터 2100년까지의 미래 기후 데이터를 제공합니다.
MCP server를 어떻게 시작하나요?
uvx --from 'epwtools[mcp]' epw-tools-mcp 명령어를 사용하여 uvx로 서버를 실행할 수 있습니다.