mcp-french-energy-open-data
# mcp-french-energy-open-data
MCP server for French open energy data: ODRE, éCO2mix, RTE/Enedis source discovery, and electricity mix helpers.
## Tools
Run the MCP and call `french_energy_open_data_get_sources` first to inspect source coverage. This server also exposes domain-specific tools for the topic described above.
Includes ODRE catalog search, recent éCO2mix rows, and a computed electricity mix summary.
## Install
```bash
npm install
npm run build
npm test
npm run dev
```
## Claude Desktop
```json
{
"mcpServers": {
"french-energy-open-data": {
"command": "npx",
"args": ["mcp-french-energy-open-data"]
}
}
}
```
## Sources
- ODRE OpenDataSoft portal: https://odre.opendatasoft.com/
- éCO2mix national real-time dataset: https://odre.opendatasoft.com/explore/dataset/eco2mix-national-tr/
- RTE éCO2mix downloads: https://www.rte-france.com/en/data-publications/eco2mix/download-indicators
- RTE services portal: https://www.services-rte.com/
## Publishing
See [docs/publishing.md](docs/publishing.md).
## Glama / Docker
The repo includes `Dockerfile` and `glama.json`.
Build steps:
```json
["npm install", "npm run build"]
```
CMD arguments:
```json
["node", "dist/index.js"]
```
## Safety
This MCP helps agents discover and summarize public sources. It is not an official authority. Verify decisions against the competent public service or original data producer.
## License
MIT
TDQS
Scored across 5 tools
The five tools have mostly distinct purposes: listing curated sources, fetching excerpts, fetching éCO2mix data, searching ODRE catalog, and searching data.gouv. There is minor potential confusion between 'get_eco2mix_latest' and 'search_odre_catalog' since both relate to ODRE data, but their descriptions (fetch recent rows vs search catalog) clarify the distinction.
All tools use the server prefix 'french_energy_open_data_' and verbs like get, fetch, search. The pattern is consistent in structure, though 'get_sources' and 'fetch_source_excerpt' use slightly different verbs for similar retrieval actions, which is a minor deviation from a uniform verb_noun pattern.
Five tools is a reasonable scope for an energy open-data server, not too thin nor too heavy. Each tool addresses a specific function: data source management, data retrieval, and catalog search. It may be slightly lean but appropriate for the stated purpose.
The tool set covers browsing sources, fetching excerpts, retrieving latest éCO2mix data, and searching two catalogs. Notable gaps include lacking ability to query historical éCO2mix data or access full dataset details, which agents might need. The surface is sufficient for basic queries but not exhaustive for the energy domain.