@epwforge/mcp
v0.0.1
Published
MCP server for EPWForge — generate, morph, and download EPW weather files for EnergyPlus, OpenStudio, IES VE, and eQUEST. TMYx, AMY, CMIP6 future-climate scenarios, and wildfire smoke overlays for AI agents.
Maintainers
Keywords
Readme
epwforge-mcp
MCP server for EPWForge — give Claude, Cursor, and other AI agents the ability to generate, morph, and download weather files for building energy simulation.
Status: Reserved name. The public MCP server is in active development. Star this repo or visit epwforge.com for launch updates.
What is EPWForge?
EPWForge generates, morphs, and serves weather files (.epw, .tmy, .amy) for building energy simulation tools — EnergyPlus, OpenStudio, IES VE, eQUEST, and any workflow that consumes EPW. The platform supports:
- TMYx generation anywhere — typical meteorological years synthesized from ERA5 reanalysis for any global lat/lon, not just airport stations
- Climate morphing — apply CMIP6 future-scenario deltas (SSP1-2.6, SSP2-4.5, SSP5-8.5) to baseline weather files for resilience and adaptation studies
- AMY (Actual Meteorological Year) — historical hourly weather for hindcasting, calibration, and post-occupancy analysis
- Wildfire smoke overlays — CAMS aerosol optical depth integrated into solar radiation channels
- Programmatic API + UI — pull files via REST or browse the globe interface at epwforge.com
What this MCP does
This package will expose EPWForge as Model Context Protocol tools so AI agents can request, generate, and morph weather files directly. Planned tools include:
| Tool | Purpose |
|---|---|
| search_locations | Find cities or coordinates with available data |
| get_location_metadata | Climate zone, available years, data sources |
| generate_tmyx | Synthesize a typical meteorological year for any lat/lon |
| get_amy | Pull an actual meteorological year for a specific year |
| morph_to_future | Apply CMIP6 climate deltas to a baseline file |
| apply_smoke_overlay | Layer wildfire smoke (AOD) onto solar channels |
| download_epw | Retrieve a generated file as bytes or a signed URL |
| get_quota | Check remaining tier allowance |
Authentication is by EPWForge API key (set via the EPWFORGE_API_KEY environment variable) — the same key that authorizes the REST API.
Install (placeholder)
# npm
npm install -g epwforge-mcp
# pip
pip install epwforge-mcpThese commands install the stub today. The functional MCP server will ship on the same package names.
Connecting to Claude
Once published, configure Claude Desktop or Claude Code by adding to your MCP config:
{
"mcpServers": {
"epwforge": {
"command": "npx",
"args": ["epwforge-mcp"],
"env": { "EPWFORGE_API_KEY": "your-key-here" }
}
}
}Get your API key at epwforge.com.
Links
- Website: epwforge.com
- Maker: Guzzlabs
- Issues: github.com/guzzlabs/epwforge-mcp/issues
License
MIT
