mcp-gouv-fr

MCP server built with FastMCP for Claude Desktop, Cursor, and other clients. Use it to explore French public open data through ready-made tools instead of calling each portal yourself.

Source repository: github.com/gghez/mcp-gouv-fr

APIs

data.gouv.fr

Tools use the datagouv_ prefix.

geo.api.gouv.fr

Tools use the geo_ prefix.

INSEE API Sirene

Tools use the insee_ prefix. Set MCP_GOUV_INSEE_API_KEY or these tools will report a configuration error.

Radio France Open API

Tools use the radiofrance_ prefix. Set MCP_GOUV_RADIOFRANCE_API_TOKEN for radiofrance_graphql.

Default transport is stdio for local MCP clients; streamable HTTP is optional for remote access (see Transports and CLI options).

Prerequisites

• uv installed and available on your PATH (so uvx works).

• This project targets Python 3.14 (requires-python in pyproject.toml). uv will provision a compatible interpreter when installing from Git or from a local checkout.

• If you use uvx with a git+https://... URL (recommended install-from-GitHub flow below), Git must be installed and git must be on the PATH of the MCP subprocess. uv clones or updates the repo using Git; if Git is missing you get: Git executable not found. On Windows, Claude Desktop sometimes spawns MCP servers with a shorter PATH than your terminal: either use the clone + uv run setup, or extend PATH in the server env block (see below).

Recommended setup: MCP config with uvx (GitHub)

uvx runs the published console script mcp-gouv-fr in an isolated environment. You can point it at this repository with --from and a Git URL (no manual clone required).

Command shape:

uvx --from git+https://github.com/gghez/mcp-gouv-fr.git mcp-gouv-fr

Optional: pin a branch, tag, or commit after @ in the URL (see uv tools guide), for example git+https://github.com/gghez/mcp-gouv-fr.git@v0.1.0.

Claude Desktop (claude_desktop_config.json)

Typical path on Windows: %APPDATA%\Claude\claude_desktop_config.json.

{
  "mcpServers": {
    "mcp-gouv-fr": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/gghez/mcp-gouv-fr.git",
        "mcp-gouv-fr"
      ],
      "env": {
        "PATHEXT": ".COM;.EXE;.BAT;.CMD;.VBS;.VBE;.JS;.JSE;.WSF;.WSH;.MSC;.PY;.PYW"
      }
    }
  }
}

Restart Claude Desktop after editing. If uvx is not found, use the full path to the uv executable and run uv tool run instead of uvx, or add uv to your user PATH.

If uv fails with “Git executable not found” (common on Windows), the MCP host did not expose git on PATH. Fixes:

1. System-wide (simplest): add C:\Program Files\Git\cmd (or your Git install) to the user or system PATH in Windows Settings so GUI apps (Claude Desktop) inherit it, then restart Claude.

2. Per server: set env.PATH in the MCP JSON to a single string that lists every folder the process needs, in order — at minimum Git’s cmd and the folder containing uv.exe / uvx.exe (e.g. C:\Users\YOU\.local\bin). Some clients replace the process PATH entirely when env is set, so do not rely on ${PATH} expansion unless you verified your client merges variables.

3. Avoid Git at MCP startup: use clone + uv run (uv run --directory … mcp-gouv-fr) after uv sync in that clone; uv then runs the project without cloning from Git on each start.

Cursor and other editors

Use the same JSON shape in your MCP servers configuration: command uvx, args as above. For stdio, do not pass extra arguments unless you need non-default transport (see below).

If uvx is not on PATH (Windows)

Use the full path to uv.exe and the equivalent invocation:

{
  "mcpServers": {
    "mcp-gouv-fr": {
      "command": "C:\\Users\\YOU\\AppData\\Local\\Programs\\uv\\uv.exe",
      "args": [
        "tool",
        "run",
        "--from",
        "git+https://github.com/gghez/mcp-gouv-fr.git",
        "mcp-gouv-fr"
      ]
    }
  }
}

Adjust the command path to match your uv installation.

Alternative: clone the repo and run with uv

For a fixed checkout or local changes:

git clone https://github.com/gghez/mcp-gouv-fr.git
cd mcp-gouv-fr
uv sync
uv run mcp-gouv-fr

MCP JSON (stdio) — set --directory to your clone:

{
  "mcpServers": {
    "mcp-gouv-fr": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "C:\\path\\to\\mcp-gouv-fr",
        "mcp-gouv-fr"
      ]
    }
  }
}

Transports and CLI options

Default is stdio (suitable for Claude Desktop and Cursor).

uvx --from git+https://github.com/gghez/mcp-gouv-fr.git mcp-gouv-fr --transport stdio

Streamable HTTP (bind address, port, path can be changed):

uvx --from git+https://github.com/gghez/mcp-gouv-fr.git mcp-gouv-fr --transport streamable-http --host 127.0.0.1 --port 8765 --path /mcp

Environment variables (optional): MCP_GOUV_TRANSPORT, MCP_GOUV_HOST, MCP_GOUV_PORT, MCP_GOUV_HTTP_PATH, MCP_GOUV_APIS (comma-separated API ids; default: all), MCP_GOUV_LOG_LEVEL (logging level for stderr; default: INFO).

Environment variables (API behavior)

In MCP JSON, set these under env next to command / args if your client supports it.

INSEE Sirene (API key required)

Unlike data.gouv and geo.api.gouv.fr, Sirene lookups will not work until you set an API key. Subscribe to the Sirene API on the INSEE developer portal, generate a consumer key, and expose it to the MCP process as MCP_GOUV_INSEE_API_KEY. The server sends it as the X-INSEE-Api-Key-Integration header to api.insee.fr. If this variable is missing or empty, the insee_* tools return an error that asks you to configure it.

When using Claude Desktop or Cursor, add MCP_GOUV_INSEE_API_KEY to the server’s environment (e.g. env in the MCP JSON config) so the subprocess inherits it.

Development

Contributors: tests and lint live in the repo. Run uv run pytest and uv run ruff check src. Install Git hooks with uv run pre-commit install (runs ruff check --fix on commit). Tool outputs use Pydantic models (JSON Schema for MCP clients). See AGENTS.md for layout conventions (nested tests next to the code they cover).

License

Not set yet (no LICENSE file in this repository).