Steddion Energy MCP Server

MCP-server voor de Nederlandse energiemarkt: day-ahead prijzen, onbalansprijzen, weersvoorspellingen en BESS-businesscases.

Tools

Related MCP server: nl-opendata-mcp

Installatie & draaien

Vereisten

• Python 3.11+

• uv (package manager)

Installeren

git clone https://github.com/lars-kerkhof/mcp-steddion.git
cd mcp-steddion
uv sync

Environment variabelen

cp .env.example .env
# Bewerk .env en vul je ENTSO-E API token in (optioneel — zonder token draait de server op mock-data)

Server starten

uv run python -m steddion_mcp

De server draait dan op http://localhost:8000/mcp.

Tests draaien

uv run pytest

Koppelen aan ChatGPT (Developer Mode)

ChatGPT ondersteunt geen lokale stdio-servers. Je moet de server via HTTPS bereikbaar maken.

Stap 1: Server starten

uv run python -m steddion_mcp

Stap 2: Tunnel opzetten

Kies een van:

Cloudflared (aanbevolen):

cloudflared tunnel --url http://localhost:8000

ngrok:

ngrok http 8000

Je krijgt een HTTPS-URL, bijvoorbeeld https://abc123.trycloudflare.com.

Stap 3: Connector toevoegen in ChatGPT

1. Open ChatGPT → Settings → Apps/Connectors

2. Schakel Developer Mode in

3. Klik Add Connector → Custom

4. Vul de URL in: https://<jouw-tunnel-url>/mcp

5. Sla op — de tools verschijnen nu in ChatGPT

Architectuur

steddion_mcp/
├── server.py      # FastMCP server, tool-registraties
├── entsoe.py      # ENTSO-E day-ahead prijzen
├── tennet.py      # TenneT onbalansprijzen
├── weather.py     # Open-Meteo weersdata
├── bess.py        # BESS businesscase calculator
├── models.py      # Pydantic response-modellen
├── mock_data.py   # Realistische mock-data generators
└── __main__.py    # Entry point

Mock-data

Alle tools vallen automatisch terug op deterministische mock-data wanneer:

• De ENTSOE_API_TOKEN ontbreekt (day-ahead prijzen)

• De TenneT API niet bereikbaar is (onbalansprijzen)

• De Open-Meteo API niet bereikbaar is (weer)

Mock-data is herkenbaar aan het veld source: "mock" in de response.