Serveur MCP Korpus

Endpoint

Outils exposés (4)

• korpus_search

  Recherche unifiée (lexicale + sémantique) sur le corpus Korpus. Renvoie une liste classée RRF (Reciprocal Rank Fusion).

  Params : text (string), jurisdictions (string[]), limit (number)

• korpus_get_article

  Récupère le contenu intégral d'un article publié (commentaire, fiche, chronique) ou d'une décision indexée par son slug ou son UUID.

  Params : idOrSlug (string)

• korpus_taxonomy_lookup

  Cherche un concept dans les vocabulaires EuroVoc, LKIF Core ou custom. Renvoie l'ID externe stable + définition + relations broader/narrower.

  Params : query (string), vocabulary (eurovoc|lkif|custom)

• korpus_magistrate_lookup

  Cherche un magistrat ou un avocat dans la base scientifique interne (réservé clients API authentifiés, accès journalisé).

  Params : name (string)

Configurer Claude Desktop

Ajoutez la configuration suivante à votre fichier ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%\Claude\claude_desktop_config.json (Windows) :

{
  "mcpServers": {
    "korpus": {
      "url": "https://www.korpus.lu/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_KORPUS_API_KEY"
      }
    }
  }
}

Redémarrez Claude Desktop. Vous verrez l'icône MCP en bas à droite indiquer "korpus" connecté. Vous pouvez désormais demander à Claude de chercher dans le corpus.

Cursor, Continue, autres clients MCP

Tout client respectant la spécification MCP peut se connecter au serveur Korpus de la même manière. La structure de configuration peut varier selon le client (Cursor utilise.cursor/mcp.json, Continue utilise sa propre configuration). L'URL et le headerAuthorizationrestent identiques.

Limites et tarification

• Gratuit pour les clients API actifs (un appel MCP = un appel API comptabilisé selon votre plan).
• Rate-limit : 60 requêtes/minute en standard, 600 req/min sur les plans Cabinet.
• Pas de log de votre clé API ni des requêtes (RGPD-friendly).
• L'outil korpus_magistrate_lookup est journalisé et audité (base scientifique interne).