MCP Serveur CEI Documentation

Un serveur MCP (Model Context Protocol) pour rechercher dans une collection documentation Directus.

🚀 Installation

1. Clonez le repository :

   git clone https://github.com/votre-username/mcp-serveur-cei-documentation.git
   cd mcp-serveur-cei-documentation
   

2. Installer les dépendances :

   npm install
   

3. Configurer les variables d'environnement :

   cp .env.example .env
   

   Modifiez le fichier .env avec vos informations Directus :

   DIRECTUS_URL=https://votre-instance-directus.com
   CEI_DOCS_BASE_URL=https://votre-docs-site.com
   DIRECTUS_TOKEN=votre-token-api-directus
   

💻 Utilisation

Démarrage du serveur

npm start

Test du serveur

npm test

Développement avec rechargement automatique

npm run dev

🛠️ Outils disponibles

recherche_documentation

Recherche dans la documentation de CEI-docs par terme ou par ID.

Paramètres :

• query (string, optionnel) : Terme de recherche (ignoré si ID est fourni)
• id (number, optionnel) : ID spécifique de la documentation à récupérer
• limit (number, optionnel) : Nombre maximum de résultats (défaut: 10)
• fields (array, optionnel) : Champs spécifiques à retourner
• filter (object, optionnel) : Filtres Directus additionnels

Exemples d'utilisation :

Recherche par terme :

{
  "query": "installation",
  "limit": 5,
  "fields": ["id", "title", "content"],
  "filter": {
    "status": "published"
  }
}

Recherche par ID :

{
  "id": 3,
  "fields": ["id", "title", "content", "status"]
}

recherche_procedures

Recherche dans les procédures de CEI-docs par terme ou par ID.

Paramètres :

• query (string, optionnel) : Terme de recherche (ignoré si ID est fourni)
• id (number, optionnel) : ID spécifique de la procédure à récupérer
• limit (number, optionnel) : Nombre maximum de résultats (défaut: 10)
• fields (array, optionnel) : Champs spécifiques à retourner
• filter (object, optionnel) : Filtres Directus additionnels

Exemples d'utilisation :

Recherche par terme :

{
  "query": "configuration",
  "limit": 5,
  "fields": ["id", "title", "description", "steps"],
  "filter": {
    "status": "published"
  }
}

Recherche par ID :

{
  "id": 49,
  "fields": ["id", "title", "description", "steps", "status"]
}

recherche_applications

Recherche dans les applications de CEI-docs par terme ou par ID.

Paramètres :

• query (string, optionnel) : Terme de recherche (ignoré si ID est fourni)
• id (number, optionnel) : ID spécifique de l'application à récupérer
• limit (number, optionnel) : Nombre maximum de résultats (défaut: 10)
• fields (array, optionnel) : Champs spécifiques à retourner
• filter (object, optionnel) : Filtres Directus additionnels

Exemples d'utilisation :

Recherche par terme :

{
  "query": "gestion",
  "limit": 5,
  "fields": ["id", "name", "description", "url", "category"],
  "filter": {
    "status": "published"
  }
}

Recherche par ID :

{
  "id": 12,
  "fields": ["id", "name", "description", "url", "category", "status"]
}

Configuration dans Claude Desktop

Ajoutez cette configuration dans votre fichier de configuration Claude Desktop :

Emplacement du fichier :

• Windows : %APPDATA%\Claude\claude_desktop_config.json
• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "documentation-cei": {
      "command": "node",
      "args": ["C:\\Users\\Utilisateur\\Documents\\DEV\\js-apps\\mcp-serveur-cei-documentation\\server.js"],
      "env": {
        "DIRECTUS_URL": "https://votre-instance-directus.com",
        "CEI_DOCS_BASE_URL": "https://votre-docs-site.com",
        "DIRECTUS_TOKEN": "votre-token-directus"
      }
    }
  }
}

Note importante : Adaptez le chemin dans args selon l'emplacement de votre serveur.

Structure du projet

mcp-serveur-cei-documentation/
├── server.js          # Serveur MCP principal
├── package.json       # Configuration npm
├── test.js            # Script de test
├── .env.example       # Exemple de variables d'environnement
└── README.md          # Documentation

Fonctionnalités

• ✅ Recherche textuelle dans la collection documentation
• ✅ Recherche textuelle dans la collection procedure
• ✅ Recherche textuelle dans la collection applications
• ✅ Support des filtres Directus
• ✅ Limitation du nombre de résultats
• ✅ Sélection de champs spécifiques
• ✅ Gestion d'erreurs complète
• ✅ Authentification via token Directus

Dépannage

1. Erreur de connexion à Directus :

   • Vérifiez que DIRECTUS_URL pointe vers votre instance
   • Vérifiez que DIRECTUS_TOKEN est valide

2. Collection 'documentation' introuvable :

   • Assurez-vous que la collection existe dans Directus
   • Vérifiez les permissions du token pour cette collection

3. Problèmes d'authentification :

   • Vérifiez que le token a les permissions de lecture sur la collection
   • Testez le token directement avec l'API Directus

API Directus utilisée

Le serveur utilise l'endpoint standard Directus :

GET /items/documentation?search={query}&limit={limit}&fields={fields}

Avec authentification Bearer Token dans les headers.