Open-source wind site suitability with bias-corrected reanalysis and a Model Context Protocol server.
- Six-factor scoring engine for wind turbine site suitability. Uses public data only: NASA POWER, ERA5, CERRA, OpenStreetMap, Open-Elevation.
- Bias-corrected wind resource. NASA POWER is statistically corrected against ERA5 and CERRA reanalysis using quantile mapping or variance scaling.
- Model Context Protocol server. Exposes the engine to Claude, Cursor, and any MCP-compatible agent through six tools.
Live demo: https://windforge.example
- Set
CDS_API_KEYin your local env to enable bias correction in development.
{
"mcpServers": {
"windforge": {
"command": "npx",
"args": ["-y", "@jamieblair/windforge-mcp"],
"env": { "CDS_API_KEY": "your-key-here" }
}
}
}import { analyseSite } from '@jamieblair/windforge-core';
const result = await analyseSite({
coordinate: { lat: 55.86, lng: -4.25 },
hubHeightM: 100,
});npx tsx packages/core/src/cli.ts 55.86 -4.25 --hub-height 100| Factor | Weight | Source |
|---|---|---|
| Wind resource | 0.35 | NASA POWER, optionally bias-corrected against ERA5 / CERRA |
| Terrain suitability | 0.20 | Open-Elevation (slope, surface roughness) |
| Grid proximity | 0.15 | OpenStreetMap Overpass (transmission lines, substations) |
| Land use compatibility | 0.15 | OpenStreetMap (protected areas, residential buffers, farmland) |
| Planning feasibility | 0.10 | Nominatim region context, OSM existing wind farms, density proxy |
| Access logistics | 0.05 | OpenStreetMap road network |
See docs/TECHNICAL-SPEC.md for the full scoring rubric, thresholds, and confidence rules.
WindForge is a pnpm + Turborepo monorepo with strict separation between core (pure TypeScript, headless, zero React or DOM dependencies) and ui (React, Recharts, Leaflet). The MCP server wraps core for AI agent consumption, and the demo app composes core and ui into the live analyse page.
packages/
core/ Scoring engine, datasource clients, analysis modules
ui/ React components (charts, maps, score cards)
mcp/ Model Context Protocol server (six tools over stdio)
demo/ Next.js 15 demo app (the live site)
NASA POWER provides global wind data at roughly 50km resolution but is known to systematically misestimate speeds in complex terrain. WindForge fetches ERA5 (about 31km) or CERRA (about 5.5km, Europe) reanalysis when a Copernicus CDS API key is configured, then statistically corrects NASA POWER against the higher-resolution reference using quantile mapping or variance scaling. The corrected series, before-and-after diagnostics, and confidence rating are surfaced in every analysis. See docs/BIAS-CORRECTION.md for the full methodology.
- Technical specification. Every file, every function, every export.
- Architecture. Design decisions and invariants.
- Bias correction methodology. Algorithms, references, validation.
- Roadmap. What is next. Honest version.
- Contributing. How to help.
- Changelog. Version history.
- Pre-publish checklist. Release process.
pnpm install
pnpm test
pnpm dev --filter @jamieblair/windforge-demoNode 20 or later and pnpm 9 or later are expected.
pnpm check # Typecheck, lint, tests, build verification
pnpm test # 925 tests across four packages
pnpm test:watch # Vitest UIThe pnpm check script aggregates the typecheck, lint, full test run, demo production build verification, and the MCP package validation. CI mirrors this gate.
pnpm --filter @jamieblair/windforge-mcp validate-publish
cd packages/mcp && npm publishThe validator asserts tarball size, contents, package.json metadata, and required README sections before allowing a publish.
License: MIT. See LICENSE.
Author: Jamie Blair, jamieblair.co.uk.
WindForge stands on public datasets. Thanks to the teams that maintain them.
- NASA POWER for global hourly, daily, and monthly meteorology.
- ECMWF ERA5 for global reanalysis.
- Copernicus CERRA for European high-resolution reanalysis.
- OpenStreetMap contributors for grid, land use, and road data, available under the Open Database License.
- Open-Elevation for free elevation queries.
Built in Scotland.