epwforge-mcp 0.0.1__tar.gz

epwforge_mcp-0.0.1/.gitignore

@@ -0,0 +1,12 @@
+node_modules/
+*.log
+.DS_Store
+dist/
+build/
+*.egg-info/
+__pycache__/
+*.pyc
+.venv/
+venv/
+.env
+.env.local

epwforge_mcp-0.0.1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Guzzlabs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

epwforge_mcp-0.0.1/PKG-INFO

@@ -0,0 +1,97 @@
+Metadata-Version: 2.4
+Name: epwforge-mcp
+Version: 0.0.1
+Summary: 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.
+Project-URL: Homepage, https://epwforge.com
+Project-URL: Repository, https://github.com/guzz-labs/epwforge-mcp
+Project-URL: Issues, https://github.com/guzz-labs/epwforge-mcp/issues
+Author-email: Guzzlabs <tuna@guzzlabs.com>
+License: MIT
+License-File: LICENSE
+Keywords: ai-agent,amy,building-energy-simulation,claude,climate-adaptation,climate-deltas,cmip6,energy-modeling,energyplus,epw,epwforge,equest,era5,future-weather,guzzlabs,ies-ve,mcp,mcp-server,model-context-protocol,openstudio,tmy,tmyx,weather-file,weather-morphing,wildfire-smoke
+Classifier: Development Status :: 1 - Planning
+Classifier: Intended Audience :: Developers
+Classifier: Intended Audience :: Science/Research
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Scientific/Engineering :: Atmospheric Science
+Classifier: Topic :: Scientific/Engineering :: Physics
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+
+# epwforge-mcp
+
+> MCP server for [EPWForge](https://epwforge.com) — 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](https://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](https://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)
+
+```bash
+# npm
+npm install -g epwforge-mcp
+
+# pip
+pip install epwforge-mcp
+```
+
+These 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:
+
+```json
+{
+  "mcpServers": {
+    "epwforge": {
+      "command": "npx",
+      "args": ["epwforge-mcp"],
+      "env": { "EPWFORGE_API_KEY": "your-key-here" }
+    }
+  }
+}
+```
+
+Get your API key at [epwforge.com](https://epwforge.com).
+
+## Links
+
+- **Website:** [epwforge.com](https://epwforge.com)
+- **Maker:** [Guzzlabs](https://guzzlabs.com)
+- **Issues:** [github.com/guzz-labs/epwforge-mcp/issues](https://github.com/guzz-labs/epwforge-mcp/issues)
+
+## License
+
+MIT

epwforge_mcp-0.0.1/README.md

@@ -0,0 +1,72 @@
+# epwforge-mcp
+
+> MCP server for [EPWForge](https://epwforge.com) — 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](https://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](https://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)
+
+```bash
+# npm
+npm install -g epwforge-mcp
+
+# pip
+pip install epwforge-mcp
+```
+
+These 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:
+
+```json
+{
+  "mcpServers": {
+    "epwforge": {
+      "command": "npx",
+      "args": ["epwforge-mcp"],
+      "env": { "EPWFORGE_API_KEY": "your-key-here" }
+    }
+  }
+}
+```
+
+Get your API key at [epwforge.com](https://epwforge.com).
+
+## Links
+
+- **Website:** [epwforge.com](https://epwforge.com)
+- **Maker:** [Guzzlabs](https://guzzlabs.com)
+- **Issues:** [github.com/guzz-labs/epwforge-mcp/issues](https://github.com/guzz-labs/epwforge-mcp/issues)
+
+## License
+
+MIT

epwforge_mcp-0.0.1/pyproject.toml

@@ -0,0 +1,65 @@
+[build-system]
+requires = ["hatchling"]
+build-backend = "hatchling.build"
+
+[project]
+name = "epwforge-mcp"
+version = "0.0.1"
+description = "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."
+readme = "README.md"
+license = { text = "MIT" }
+requires-python = ">=3.10"
+authors = [
+    { name = "Guzzlabs", email = "tuna@guzzlabs.com" }
+]
+keywords = [
+    "mcp",
+    "mcp-server",
+    "model-context-protocol",
+    "claude",
+    "ai-agent",
+    "epw",
+    "weather-file",
+    "energyplus",
+    "openstudio",
+    "ies-ve",
+    "equest",
+    "tmy",
+    "tmyx",
+    "amy",
+    "weather-morphing",
+    "climate-deltas",
+    "future-weather",
+    "cmip6",
+    "era5",
+    "building-energy-simulation",
+    "energy-modeling",
+    "climate-adaptation",
+    "wildfire-smoke",
+    "epwforge",
+    "guzzlabs",
+]
+classifiers = [
+    "Development Status :: 1 - Planning",
+    "Intended Audience :: Science/Research",
+    "Intended Audience :: Developers",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Topic :: Scientific/Engineering :: Atmospheric Science",
+    "Topic :: Scientific/Engineering :: Physics",
+]
+
+[project.urls]
+Homepage = "https://epwforge.com"
+Repository = "https://github.com/guzz-labs/epwforge-mcp"
+Issues = "https://github.com/guzz-labs/epwforge-mcp/issues"
+
+[project.scripts]
+epwforge-mcp = "epwforge_mcp:main"
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/epwforge_mcp"]

epwforge_mcp-0.0.1/src/epwforge_mcp/__init__.py

@@ -0,0 +1,18 @@
+"""epwforge-mcp: MCP server for EPWForge weather file generation and morphing.
+
+This package name is reserved. The functional MCP server is in development.
+Visit https://epwforge.com for launch updates.
+"""
+
+__version__ = "0.0.1"
+
+
+def main() -> None:
+    import sys
+    print(
+        "epwforge-mcp: this package name is reserved. "
+        "The functional MCP server is in development.\n"
+        "Visit https://epwforge.com for launch updates.",
+        file=sys.stderr,
+    )
+    sys.exit(0)