# Energy Grid MCP Server

MCP-Server für Stromnetz-Daten — CO2-Intensität, Strommix, Preise und optimale Zeitfenster für energieintensive KI-Tasks.

[![PyPI](https://img.shields.io/pypi/v/energy-grid-mcp-server)](https://pypi.org/project/energy-grid-mcp-server/)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

## Features

- **CO2-Intensität** — Echtzeit-Gramm CO2 pro kWh (UK kostenlos ohne Key, global mit Electricity Maps Key)
- **Grüne Zeitfenster** — Findet die nächsten 48h mit niedrigster CO2-Intensität für GPU-Jobs
- **Strommix** — Anteil Wind, Solar, Atom, Gas, Kohle in Echtzeit
- **Strompreise** — Großhandelspreise Deutschland (SMARD, kein Key) + EU Day-Ahead (ENTSO-E, optionaler Key)
- **48h Prognose** — CO2-Intensitäts-Vorhersage für smarte Task-Planung

## Installation

```bash
pip install energy-grid-mcp-server
```

Oder mit `uvx` (kein Install nötig):
```bash
uvx energy-grid-server
```

## Claude Desktop Konfiguration

```json
{
  "mcpServers": {
    "energy-grid": {
      "command": "uvx",
      "args": ["energy-grid-server"],
      "env": {
        "ELECTRICITY_MAPS_TOKEN": "optional",
        "ENTSOE_TOKEN": "optional"
      }
    }
  }
}
```

## Tools

| Tool | Beschreibung | Key nötig? |
|------|-------------|-----------|
| `get_uk_carbon_intensity` | CO2-Intensität UK (national + regional) | Nein |
| `get_carbon_intensity_forecast` | 48h CO2-Prognose UK | Nein |
| `find_greenest_time_window` | Bestes Zeitfenster für AI-Tasks | Nein |
| `get_uk_power_mix` | Strommix UK (Wind, Solar, etc.) | Nein |
| `get_renewable_percentage_uk` | Erneuerbaren-Anteil UK | Nein |
| `get_germany_wholesale_price` | Großhandelspreis DE (SMARD) | Nein |
| `get_global_carbon_intensity` | CO2-Intensität weltweit | Electricity Maps |
| `get_global_power_mix` | Strommix weltweit | Electricity Maps |
| `get_eu_day_ahead_prices` | Day-Ahead Preise EU | ENTSO-E |

## API-Keys (alle optional)

- **Electricity Maps** (global CO2): [api-portal.electricitymaps.com](https://api-portal.electricitymaps.com) — 100k Calls/Monat kostenlos
- **ENTSO-E** (EU-Preise): [transparency.entsoe.eu](https://transparency.entsoe.eu) — kostenlos nach Registrierung

UK-Daten und deutsche Großhandelspreise funktionieren **ohne API-Keys**.

## Anwendungsfälle

```
"Wann ist der beste Zeitpunkt heute für mein GPU-Training? CO2 soll minimal sein."
"Wie hoch ist der aktuelle Anteil erneuerbarer Energien im UK-Stromnetz?"
"Gib mir den aktuellen Großhandelsstrompreis in Deutschland."
"Erstelle einen Plan für meinen Batch-Job in den nächsten 48h mit niedrigstem CO2-Ausstoß."
```

## Datenquellen

- [Carbon Intensity UK API](https://carbonintensity.org.uk/) — National Grid ESO (kostenlos)
- [Electricity Maps](https://electricitymaps.com/) — Globale Echtzeit-CO2-Daten
- [SMARD](https://www.smard.de/) — Bundesnetzagentur Strommarkt-Daten
- [ENTSO-E](https://transparency.entsoe.eu/) — Europäische Übertragungsnetzbetreiber

## License

MIT — AiAgentKarl
