--- ok_version: "0.2" type: Project title: "Fonctionnalités de Kiso" description: "Fonctionnalités de Kiso CLI et Kiso MCP Server pour valider, publier et interroger des bases de connaissances Open Knowledge Format." resource: https://oak-invest.github.io/kiso/ tags: [project, kiso, fonctionnalites, okf, mcp] entity: kiso canonical: false status: stable generated: by: human:straumat at: '2026-08-23T21:52:13+02:00' verified: - by: human:straumat at: '2026-10-11T15:44:13Z' sources: - id: ref-50a58b4f6558 resource: https://modelcontextprotocol.io/ title: Model Context Protocol --- # Fonctionnalités de Kiso Kiso propose deux applications qui exploitent le même bundle Open Knowledge Format : `kiso-cli` pour le valider et le publier, et `kiso-mcp-server` pour donner aux agents d’IA un accès direct à son contenu. ## Kiso CLI ### Vérification d'un bundle OKF La commande `check` contrôle les fichiers Markdown d’un bundle avant sa publication. Elle signale les erreurs de format ou de structure et remonte les liens cassés sous forme d’avertissements. ```bash kiso-cli check --source=ma-base-de-connaissances ``` Cette vérification peut être lancée localement ou dans une chaîne d’intégration continue afin de détecter rapidement les contenus non conformes. ### Génération d'un site statique La commande `build` transforme le bundle en site web statique : ```bash kiso-cli build \ --source=ma-base-de-connaissances \ --destination=public ``` Le répertoire généré contient notamment : - des pages HTML structurées et navigables ; - les fichiers Markdown d’origine, consultables et réutilisables par les humains comme par les agents ; - un fichier `llms.txt` facilitant la découverte du contenu par les systèmes d’IA ; - un fichier `sitemap.xml` destiné aux moteurs d’indexation. Le résultat est entièrement statique. Il peut être ouvert localement ou publié sur GitHub Pages et, plus généralement, sur n’importe quel serveur HTTP ou service d’hébergement statique. ### Configuration de la publication Un fichier facultatif `.kiso/configuration.yaml`, placé à la racine du bundle, permet de configurer : - l’URL publique, le nom, la langue, le titre et la description du site ; - le thème DaisyUI utilisé pour le rendu ; - les fichiers et répertoires à exclure de la publication au moyen de motifs glob. Kiso propose aussi des **profils de publication** dans `.kiso//configuration.yaml`. Un même bundle peut ainsi produire, par exemple, une édition publique et une édition interne sans modifier son contenu source. ```bash kiso-cli build --profile=public kiso-cli build --profile=internal ``` ### Intégration continue avec GitHub Actions Kiso CLI peut vérifier, construire et publier automatiquement une base OKF lors d’un changement dans le dépôt : ```yaml - name: Build with Kiso uses: oak-invest/kiso/applications/kiso-cli-action@v0.2.1 with: command: build source: examples/kb-google-example destination: public/kb-google-example ``` Cette intégration permet de conserver le bundle OKF dans Git tout en automatisant la génération et le déploiement du site. ## Kiso MCP Server ### Exposition d'un bundle via MCP `kiso-mcp-server` charge un bundle OKF et démarre un serveur compatible avec le [Model Context Protocol](https://modelcontextprotocol.io/). Une application d’IA peut alors explorer la base de connaissances sans passer par le site généré. ```bash kiso-mcp-server --source=ma-base-de-connaissances ``` Par défaut, le serveur écoute sur le port `8080` et expose son point d’entrée MCP à l’adresse suivante : ```text http://localhost:8080/mcp ``` Le port peut être modifié avec l’option `--port` : ```bash kiso-mcp-server \ --source=ma-base-de-connaissances \ --port=8081 ``` ### Recherche dans la connaissance L’outil MCP `search` effectue une recherche textuelle parmi les concepts du bundle. L’index prend en compte le titre, la description, les tags et le corps des documents. Chaque résultat fournit l’identifiant du concept, son titre, sa description et un score de pertinence. Cette première étape permet à l’agent d’identifier les concepts susceptibles de répondre à sa question sans charger toute la base dans son contexte. ### Récupération du contenu d'un concept L’outil MCP `get_concept_content` retourne le fichier Markdown d’origine correspondant à un identifiant de concept. L’agent peut ainsi récupérer le contenu complet d’un résultat pertinent, métadonnées comprises, puis l’utiliser comme contexte. Le parcours type est donc : 1. rechercher les concepts pertinents avec `search` ; 2. sélectionner un ou plusieurs identifiants de concept ; 3. récupérer leur contenu avec `get_concept_content` ; 4. exploiter cette connaissance dans la réponse ou la tâche en cours. ### Accès sans modification du bundle Le serveur MCP ne génère aucun site et ne modifie pas les fichiers sources. Le bundle OKF reste la source de vérité, tandis que le serveur fournit une interface de lecture adaptée aux agents d’IA. ## Complémentarité des deux applications | Besoin | Application | Résultat | |---|---|---| | Contrôler la structure et les métadonnées | `kiso-cli check` | Rapport d’erreurs et d’avertissements | | Publier pour les humains et les moteurs | `kiso-cli build` | Site statique, Markdown, `llms.txt` et `sitemap.xml` | | Automatiser la publication | Action GitHub de Kiso CLI | Construction et déploiement dans la CI | | Rechercher des concepts depuis une IA | `kiso-mcp-server` | Résultats structurés via MCP | | Fournir le contenu source à un agent | `kiso-mcp-server` | Markdown original d’un concept | Les deux applications peuvent être utilisées séparément ou ensemble. Une organisation peut publier un site documentaire destiné à ses équipes tout en connectant ses assistants et agents d’IA au même bundle OKF.