data.gouv.fr MCP — Casos de uso, Instalar & Demo ao vivo

Name: data.gouv.fr MCP Server
Author: datagouv

Por que usar

Principais recursos

Busca em texto completo em dezenas de milhares de conjuntos de dados públicos
Metadados (licença, publicador, frequência de atualização, tags) para cada conjunto de dados
URLs de recursos (CSV/JSON/XLSX) para download direto
Sem chave API — dados totalmente públicos
Cobertura: demografia, transporte, meio ambiente, saúde, eleições, INSEE etc.

Demo ao vivo

Como fica na prática

datagouv.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "datagouv": {
      "command": "uvx",
      "args": [
        "datagouv-mcp"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "datagouv": {
      "command": "uvx",
      "args": [
        "datagouv-mcp"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "datagouv": {
      "command": "uvx",
      "args": [
        "datagouv-mcp"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "datagouv": {
      "command": "uvx",
      "args": [
        "datagouv-mcp"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "datagouv",
      "command": "uvx",
      "args": [
        "datagouv-mcp"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "datagouv": {
      "command": {
        "path": "uvx",
        "args": [
          "datagouv-mcp"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add datagouv -- uvx datagouv-mcp

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: data.gouv.fr

Encontrar um conjunto de dados público francês por tema

👤 Jornalistas, pesquisadores, desenvolvedores de civic-tech ⏱ ~10 min beginner

Quando usar: Você precisa de 'desemprego por département, mensal' ou similar e não sabe onde encontrá-lo.

Fluxo

Buscar por palavras-chave

Busque em data.gouv.fr por 'chômage département mensuel'. Retorne os 10 principais conjuntos de dados com título, publicador, última atualização.✓ Copiado

→ Lista de conjuntos de dados relevantes
Inspecionar os mais promissores

Pelos 3 principais, obtenha metadados completos: licença, frequência de atualização, recursos, descrição. Qual é o mais atual + oficial?✓ Copiado

→ Resumo comparativo
Obter URLs de download

Retorne a(s) URL(s) de recurso CSV para o conjunto de dados escolhido. Farei o download separadamente.✓ Copiado

→ URL(s) de download direto

Resultado: Uma lista curta de conjuntos de dados autoritativos com links de download direto.

Armadilhas

Conjuntos de dados às vezes têm URLs de recursos quebradas — Verifique os metadados 'last_modified'; mais antigo + não mantido = mais provavelmente quebrado. Prefira o publicado por INSEE se disponível.

Combine com: filesystem

Catalogar todos os conjuntos de dados publicados por um ministério ou agência específica

👤 Pesquisadores mapeando disponibilidade de dados ⏱ ~15 min intermediate

Quando usar: Você quer saber tudo que INSEE ou Ministère de la Transition écologique publica.

Fluxo

Pesquisar a organização

Encontre a página da organização data.gouv para 'INSEE'. Retorne seu slug.✓ Copiado

→ ID canônico da org
Listar todos os conjuntos de dados

Liste todos os conjuntos de dados publicados por essa org. Percorra todos os resultados. Retorne título, id, última atualização, contagem de recursos.✓ Copiado

→ Catálogo completo
Categorizar

Agrupe por tema (população, economia, território, etc.). Conte conjuntos de dados por tema.✓ Copiado

→ Histograma temático

Resultado: Um inventário estruturado de dados abertos de uma org pública francesa.

Armadilhas

Orgs grandes têm 1000+ conjuntos de dados — paginação importa — Sempre percorra todos os resultados; não confie que a primeira página esteja completa

Combine com: filesystem

Observar novos conjuntos de dados publicados ou atualizados sobre um tópico

👤 Civic tech / analistas de políticas ⏱ ~15 min intermediate

Quando usar: Você quer ser alertado quando novos conjuntos de dados COVID/eleição/moradia aparecerem.

Fluxo

Busca de linha de base hoje

Busque '<topic>' e salve os 50 principais ids de conjunto de dados + datas last_modified como /data/datagouv-<topic>-baseline.json.✓ Copiado

→ Linha de base salva
Execução semanal

Execute a busca novamente. Compare com a linha de base. Retorne (a) novos conjuntos de dados não na linha de base, (b) conjuntos de dados cuja last_modified aumentou.✓ Copiado

→ Relatório Delta
Destacar os interessantes

Filtre o delta por publicadores oficiais (ministérios, INSEE, agências). Produza um resumo de 1 linha por conjunto de dados novo/atualizado.✓ Copiado

→ Resumo curado

Resultado: Um alerta semanal sobre novos dados franceses autoritativos em seu tópico.

Armadilhas

Agregadores republicam dados antigos com novo last_modified — ruído — Prefira conjuntos de dados cujo publicador seja uma org oficial, não uma comunidade republicadora

Combine com: filesystem

Combinações

Combine com outros MCPs para 10× de alavancagem

datagouv + filesystem

Baixar e arquivar conjuntos de dados localmente

Busque 'recensement population' em data.gouv, escolha o de INSEE, baixe CSV, salve em /data/insee/.✓ Copiado

datagouv + postgres

Ingerir um conjunto de dados abertos francês em Postgres para análise

Baixe o conjunto de dados de desemprego mais recente, infira o schema, CREATE TABLE e COPY para Postgres.✓ Copiado

datagouv + antv-chart

Gráfico rápido de um conjunto de dados abertos francês

Baixe conjunto de dados X, filtre para 2020-2024, renderize como gráfico de linha por região.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar	Custo
search_datasets	q: str, page?, page_size?	Busca por palavras-chave em conjuntos de dados	free
get_dataset	dataset_id_or_slug	Metadados completos + recursos para um conjunto de dados específico	free
search_organizations	q: str	Encontrar o id canônico de um ministério/agência	free
list_organization_datasets	org_id, page?	Catalogar a saída completa de um publicador	free

Custo e limites

O que custa rodar

Cota de API: API pública; limitação de uso justo (alguns req/seg é seguro)
Tokens por chamada: Metadados do conjunto de dados: 500–2000 tokens dependendo da contagem de campos
Monetário: Gratuito
Dica: Cache ids de conjuntos de dados localmente; metadados raramente mudam semana a semana.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: Nenhum necessário

Saída de dados: Todas as chamadas para www.data.gouv.fr e hosts de recursos

Os dados são públicos, mas as licenças variam (Licence Ouverte mais comum); sempre verifique a licença do conjunto de dados antes de redistribuição.

Solução de problemas

Erros comuns e correções

404 em get_dataset

O id do conjunto de dados mudou ou foi removido da lista. Use busca em vez de um id em cache.

Limitado por taxa

Espaçe as chamadas; <5 req/seg é seguro. Sem limite oficial, mas uso justo é aplicado.

URL do recurso retorna 403/404

Alguns conjuntos de dados têm links quebrados; prefira o recurso mais recentemente atualizado ou a própria página do publicador oficial.

Alternativas

data.gouv.fr vs. outros

Alternativa	Quando usar	Troca
data.europa.eu MCP	Você precisa de dados pan-UE, não apenas França	Mais amplo, mas menos profundidade específica francesa
INSEE API MCP	Você só precisa de estatísticas INSEE oficiais com acesso limpo à API	Escopo mais estreito; apenas escritório estatístico francês

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills