MCP 服务器

mpc-judilibre

MCP server covering French law via the PISTE platform: 8 tools wrapping the JUDILIBRE API (open data judicial decisions from Cour de cassation, courts of appeal and civil courts).

README

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

mcp-judilibre en action dans Demeter

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é :

Allez dans Mes applications → Nouvelle application (ou ouvrez votre application existante)
Donnez un nom à votre application (ex: mcp-judilibre)
Sélectionnez l'environnement Sandbox pour commencer

3. Souscrire à l'API JUDILIBRE

Dans le catalogue, recherchez JUDILIBRE
Cliquez sur Souscrire → choisissez votre application
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

Installation locale (Python)

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

Installation via Docker

git clone https://github.com/ktulu-analog/mcp-judilibre.git
cd mcp-judilibre
docker build -t mcp-judilibre .

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

En local (Python)

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

Via Docker

docker run -p 6501:6501 \
  -e JUDILIBRE_CLIENT_ID=votre_client_id \
  -e JUDILIBRE_CLIENT_SECRET=votre_client_secret \
  mcp-judilibre

Le serveur peut tourner sur n'importe quelle machine accessible en réseau. Les clients MCP se connectent alors à http://adresse-du-serveur:6501/mcp — le serveur n'a pas besoin d'être sur la même machine que le client.

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

Outil	Endpoint	Description
`judilibre_rechercher`	`GET /search`	Recherche plein texte dans les décisions de justice
`judilibre_decision`	`GET /decision`	Texte intégral et métadonnées d'une décision par ID
`judilibre_scan`	`GET /scan`	Export par lot, pagination par curseur (`search_after`)
`judilibre_export`	`GET /export`	Export par lot, pagination par numéro de lot (`batch`)
`judilibre_taxonomie`	`GET /taxonomy`	Référentiel des valeurs valides pour les filtres
`judilibre_stats`	`GET /stats`	Statistiques globales et agrégations de la base
`judilibre_historique`	`GET /transactionalhistory`	Historique des opérations create/update/delete
`judilibre_healthcheck`	`GET /healthcheck`	Vérifie la disponibilité du service API

`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 (6501 et 6502 par défaut) et être déclarés dans le même fichier de configuration MCP.

Licence

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.