mcp-judilibre

Serveur MCP HTTP Streamable donnant accès à l'API JUDILIBRE (PISTE / Cour de cassation) depuis n'importe quel client MCP : Demeter, Claude Desktop, Claude Code, applications Tauri/Electron, ou tout LLM compatible MCP.

8 outils couvrant la recherche plein texte, la consultation de décisions complètes, l'export par lot (deux modes de pagination), la taxonomie des filtres, les statistiques, l'historique transactionnel et le healthcheck.

JUDILIBRE est le moteur Open Data des décisions de justice françaises, publié par la Cour de cassation. Il couvre la Cour de cassation, les cours d'appel et les tribunaux judiciaires.

Aperçu

Prérequis

• Python 3.11+

• Un compte sur piste.gouv.fr avec accès à l'API JUDILIBRE (gratuit)

Note : Si vous utilisez déjà mcp-legifrance, les identifiants PISTE sont les mêmes. Il suffit d'ajouter la souscription à l'API JUDILIBRE dans votre application PISTE existante.

Obtenir les identifiants API

L'API JUDILIBRE est exposée via la plateforme PISTE (Plateforme d'Intermédiation des Services pour la Transformation de l'État).

1. Créer un compte PISTE

Rendez-vous sur https://piste.gouv.fr et cliquez sur S'inscrire. L'inscription est gratuite et ouverte à tous.

2. Créer une application (ou réutiliser l'existante)

Une fois connecté :

1. Allez dans Mes applications → Nouvelle application (ou ouvrez votre application existante)

2. Donnez un nom à votre application (ex: mcp-judilibre)

3. Sélectionnez l'environnement Sandbox pour commencer

3. Souscrire à l'API JUDILIBRE

1. Dans le catalogue, recherchez JUDILIBRE

2. Cliquez sur Souscrire → choisissez votre application

3. La souscription est automatiquement approuvée pour l'environnement Sandbox

4. Récupérer les identifiants

Dans votre application PISTE, copiez :

• Client ID (JUDILIBRE_CLIENT_ID)

• Client Secret (JUDILIBRE_CLIENT_SECRET)

Installation

git clone https://github.com/ktulu-analog/mcp-judilibre.git
cd mcp-judilibre
python -m venv .venv
source .venv/bin/activate   # Windows : .venv\Scripts\activate
pip install -r requirements.txt

Configuration

Copiez .env.example en .env et renseignez vos identifiants :

cp .env.example .env

JUDILIBRE_CLIENT_ID=votre_client_id
JUDILIBRE_CLIENT_SECRET=votre_client_secret

Ou exportez-les directement dans votre shell :

export JUDILIBRE_CLIENT_ID=votre_client_id
export JUDILIBRE_CLIENT_SECRET=votre_client_secret

Démarrage

python server.py

Options disponibles :

--host   Adresse d'écoute  (défaut : 0.0.0.0)
--port   Port d'écoute     (défaut : 6501)
--path   Chemin MCP        (défaut : /mcp)

Exemple sur un port personnalisé :

python server.py --port 8080

Le serveur est accessible à http://localhost:6501/mcp.

Intégration avec un client MCP

Claude Desktop

Dans claude_desktop_config.json :

{
  "mcpServers": {
    "judilibre": {
      "url": "http://localhost:6501/mcp"
    }
  }
}

Pour utiliser les deux serveurs simultanément avec mcp-legifrance :

{
  "mcpServers": {
    "legifrance": {
      "url": "http://localhost:6502/mcp"
    },
    "judilibre": {
      "url": "http://localhost:6501/mcp"
    }
  }
}

Claude Code

claude mcp add judilibre --url http://localhost:6501/mcp

Autre client HTTP Streamable

Tout client supportant la spec MCP 2025-03-26 HTTP Streamable peut se connecter à http://localhost:6501/mcp.

Outils disponibles

judilibre_rechercher

Recherche paginée avec filtres : juridiction (cc, ca, tj), chambre, formation, type de décision, solution, niveau de publication, matière, localisation, plage de dates, opérateur logique (or, and, exact).

judilibre_decision

Récupère une décision complète par son ID JUDILIBRE (obtenu via judilibre_rechercher). Retourne le texte pseudonymisé, les zones structurées, les textes appliqués, les rapprochements et les documents associés (communiqués, notes, rapports…).

judilibre_scan

Export par lot pour indexation ou synchronisation d'un corpus. Pagination par curseur via search_after (style keyset). Version abrégée disponible (abrege=True) pour ne pas inclure le texte intégral.

judilibre_export

Export par lot via pagination par numéro de lot entier (lot=0, lot=1…, style offset). Mêmes filtres que judilibre_scan. À privilégier quand on veut accéder directement à un lot précis sans avoir à parcourir les précédents.

judilibre_taxonomie

Liste les valeurs valides des filtres. Exemples :

• judilibre_taxonomie(id="chamber", contexte="cc") → chambres de la Cour de cassation

• judilibre_taxonomie(id="solution") → toutes les solutions possibles

• judilibre_taxonomie(id="jurisdiction") → types de juridictions

judilibre_stats

Statistiques mises à jour quotidiennement. Supporte des agrégations multi-axes (ex: agregations="year,chamber" pour la répartition par année et par chambre).

judilibre_historique

Flux transactionnel depuis une date ISO-8601 donnée. Retourne les opérations created, updated et deleted pour maintenir un index local synchronisé.

judilibre_healthcheck

Vérifie que l'API JUDILIBRE est opérationnelle. Aucun paramètre requis. Utile pour diagnostiquer les problèmes de connectivité.

Utilisation combinée avec mcp-legifrance

mcp-judilibre et mcp-legifrance sont complémentaires :

• JUDILIBRE → décisions de justice Open Data (Cour de cassation, cours d'appel, tribunaux judiciaires)

• Légifrance → textes législatifs et réglementaires, jurisprudence administrative (Conseil d'État, Conseil constitutionnel, CNIL…)

Les deux serveurs peuvent tourner simultanément sur des ports différents (6502 et 6503 par défaut) et être déclarés dans le même fichier de configuration MCP.

Licence

GNU Affero General Public License v3.0 — © 2026 Pierre COUGET

Disclaimer

Ce projet n'est pas un projet officiel. C'est la traduction de l'API JUDILIBRE en serveur MCP pour mes propres besoins initialement. Mais autant que ça serve à d'autres.