Aller au contenu

Serveur MCP

theKB.eu expose un serveur MCP (Model Context Protocol) public et en lecture seule sur mcp.thekb.eu : un agent y interroge le corpus de veille — fiches, thématiques, tags et graphe de connaissance — via 11 outils typés.

Endpoint & protocole

$ https://mcp.thekb.eu/

Outils cœur (7) — anonymes, sans clé

search_fiches
Recherche hybride (BM25 + sémantique multilingue) dans le corpus.
get_fiche
Une fiche complète par slug, en Markdown ou JSON.
list_fiches
Liste paginée filtrable — le pendant « parcours » de la recherche.
get_latest
Les fiches les plus récentes, optionnellement par thématique.
list_topics
Les 11 thématiques, libellés localisés et compteurs.
list_tags
Le nuage de tags avec fréquences.
get_stats
Compteurs globaux du corpus et version du build.

Outils graphe (4) — clé API requise

get_related_fiches sk_live_
Fiches proches via entités partagées du graphe.
search_entities sk_live_
Recherche dans les entités du graphe de connaissance.
get_entity sk_live_
Résout une entité par son nom, y compris les entités mineures sans page.
get_graph_neighborhood sk_live_
Voisinage d'une entité dans le graphe (1 à 2 sauts).

Accès

Les 7 outils cœur sont accessibles sans authentification (limite par IP). Rien à demander.

Les 4 outils graphe requièrent une clé API sk_live_ passée en en-tête Authorization: Bearer. Ce tier est privé, sur invitation à ce stade — les clés sont émises manuellement par le mainteneur.

Se connecter

Configuration d'un client MCP (accès cœur anonyme) :

{
  "mcpServers": {
    "thekb": {
      "type": "http",
      "url": "https://mcp.thekb.eu/"
    }
  }
}

Pour les outils graphe, ajouter la clé en en-tête :

"headers": {
  "Authorization": "Bearer sk_live_…"
}

Licence

Le corpus servi par le MCP est sous licence CC BY 4.0 : réutilisation, citation et entraînement libres, attribution à theKB.eu (avec lien) requise. CC BY 4.0.

Voir aussi