oeil-mcp

Serveur MCP pour l'Observatoire législatif du Parlement européen (OEIL).
Permet à Claude Desktop d'interroger directement les fiches de procédure législative sur oeil.europarl.europa.eu.

Installation

1. Installer Node.js (version 20.18.1 ou supérieure)

• macOS : brew install node
• Windows / Linux : télécharger la version LTS depuis nodejs.org

Vérifier : node -v doit afficher v20.18.1 ou plus.

2. Configurer Claude Desktop

Ouvrir le fichier de configuration de Claude Desktop :

| Système | Chemin | |---------|--------| | macOS | ~/Library/Application Support/Claude/claude_desktop_config.json | | Windows | %APPDATA%\Claude\claude_desktop_config.json | | Linux | ~/.config/Claude/claude_desktop_config.json |

Ajouter (ou compléter) la section mcpServers :

{
  "mcpServers": {
    "oeil": {
      "command": "npx",
      "args": ["-y", "oeil-mcp"]
    }
  }
}

3. Redémarrer Claude Desktop

Fermer et rouvrir Claude Desktop. Le serveur OEIL sera disponible automatiquement.

Exemples de questions

• « Donne-moi le statut de la procédure 2021/0239(COD) »
• « Cherche les dossiers OEIL sur le blanchiment de capitaux »
• « Télécharge le PDF complet de 2023/0355(COD) »
• « Quels sont les événements clés de la procédure 2022/0396(COD) ? »
• « Récupère le résumé du document OEIL n° 99001 »
• « Télécharge la proposition COM depuis EUR-Lex »

Outils disponibles

| Outil | Description | |-------|-------------| | get_procedure | Récupère la fiche complète d'une procédure (Markdown + JSON) | | search_procedures | Recherche par mots-clés dans l'observatoire | | get_document_summary | Récupère le résumé textuel d'un document par son ID OEIL | | list_procedure_documents | Liste tous les documents associés à une procédure avec leurs URLs | | download_procedure_pdf | Télécharge le PDF officiel d'une procédure | | download_document | Télécharge tout document officiel UE par URL (auto-conversion PDF pour EUR-Lex) |

Tous les outils acceptent un paramètre language ("fr" ou "en", défaut "fr"). Si la page française est indisponible, la version anglaise est automatiquement récupérée.

Dépannage

• « command not found: npx » — Node.js n'est pas installé ou pas dans le PATH. Réinstaller Node.js.
• Aucun outil OEIL dans Claude — Vérifier que le JSON est valide (pas de virgule en trop). Redémarrer Claude Desktop.
• Erreurs réseau — Le serveur accède directement à oeil.europarl.europa.eu. Vérifier la connexion internet.
• Timeout — Les pages OEIL peuvent être lentes. Réessayer après quelques secondes.

Vie privée

Toutes les requêtes sont envoyées directement depuis votre machine vers les serveurs du Parlement européen. Aucune donnée ne transite par un serveur tiers. Aucune télémétrie n'est collectée.

Licence

MIT