# 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


---

## More MCP Servers by AiAgentKarl

| Category | Servers |
|----------|---------|
| 🔗 Blockchain | [Solana](https://github.com/AiAgentKarl/solana-mcp-server) |
| 🌍 Data | [Weather](https://github.com/AiAgentKarl/weather-mcp-server) · [Germany](https://github.com/AiAgentKarl/germany-mcp-server) · [Agriculture](https://github.com/AiAgentKarl/agriculture-mcp-server) · [Space](https://github.com/AiAgentKarl/space-mcp-server) · [Aviation](https://github.com/AiAgentKarl/aviation-mcp-server) · [EU Companies](https://github.com/AiAgentKarl/eu-company-mcp-server) |
| 🔒 Security | [Cybersecurity](https://github.com/AiAgentKarl/cybersecurity-mcp-server) · [Policy Gateway](https://github.com/AiAgentKarl/agent-policy-gateway-mcp) · [Audit Trail](https://github.com/AiAgentKarl/agent-audit-trail-mcp) |
| 🤖 Agent Infra | [Memory](https://github.com/AiAgentKarl/agent-memory-mcp-server) · [Directory](https://github.com/AiAgentKarl/agent-directory-mcp-server) · [Hub](https://github.com/AiAgentKarl/mcp-appstore-server) · [Reputation](https://github.com/AiAgentKarl/agent-reputation-mcp-server) |
| 🔬 Research | [Academic](https://github.com/AiAgentKarl/crossref-academic-mcp-server) · [LLM Benchmark](https://github.com/AiAgentKarl/llm-benchmark-mcp-server) · [Legal](https://github.com/AiAgentKarl/legal-court-mcp-server) |

[→ Full catalog (40+ servers)](https://github.com/AiAgentKarl)

## License

MIT — AiAgentKarl