Skip to main content
Glama
Hug0x0

mcp-french-energy-open-data

by Hug0x0
README.md
# 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

B3.2/5.0

Scored across 5 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count4/5

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.

Completeness3/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo issues