Serveur MCP

Présentation

Le dépôt fournit mcp_server.py, un serveur stdio natif du Model Context Protocol. C’est une couche légère au-dessus de cette API publique — il communique avec un serveur en cours d’exécution via HTTP, afin qu’un assistant IA puisse explorer les données de transparence du DSA via des appels d’outils structurés plutôt que du HTTP brut. Aucun SQL n’est jamais exposé ; chaque requête passe par la même couche de requêtes validée que le reste de l’API.

Outils

• list_tables
  Liste les tableaux de rapports DSA et la période du jeu de données.
• describe_table
  Affiche les dimensions et mesures interrogeables d’un tableau.
• dataset_overview
  Agrégats clés pour l’ensemble du jeu de données.
• run_query
  Exécute une requête structurée (mono-table ou composite) et renvoie des lignes JSON.
• ask
  Posez une question en langage naturel ; un LLM la traduit en requête structurée validée.
• register
  Génère une clé d’API de démo à partir d’un nom et d’un e-mail — débloque les outils authentifiés ci-dessous.
• submit_query
  Soumet une tâche de requête asynchrone complète (sans limite de lignes, export CSV, requêtes composites) et renvoie un id de tâche.
• poll_job
  Interroge une tâche soumise jusqu’à son achèvement et renvoie son résultat.

submit_query, poll_job et ask nécessitent une clé d’API ; register en génère une de démo.

Connexion

Ajoutez le serveur à votre hôte MCP (par exemple le claude_desktop_config.json de Claude Desktop). Consultez docs/MCP.md pour la configuration complète, et mcp-config.example.json dans le dépôt pour un exemple prêt à l’emploi.

{
  "mcpServers": {
    "transparency-report-api": {
      "command": "/absolute/path/to/transparency-report-api/.venv-mcp/bin/python",
      "args": ["/absolute/path/to/transparency-report-api/mcp_server.py"],
      "env": {
        "TRANSPARENCY_API_URL": "https://your-deployment.example",
        "TRANSPARENCY_API_KEY": "momo"
      }
    }
  }
}

Configuré via TRANSPARENCY_API_URL, TRANSPARENCY_API_KEY et TRANSPARENCY_API_TIMEOUT. Ses dépendances (mcp + httpx) se trouvent dans requirements-mcp.txt, séparées de l’image de l’app. Besoin d’une clé ? Obtenir une clé d’API →