|
|
9 months ago | |
|---|---|---|
| mcp_server | 9 months ago | |
| .gitignore | 9 months ago | |
| README.md | 9 months ago | |
| requirements.txt | 9 months ago |
LW-Copilot est un serveur Model Context Protocol (MCP) permettant à un agent IA d'automatiser la gestion des ressources MODX. Il expose des outils pour créer, lire et modifier des ressources MODX de manière sécurisée et contextuelle.
LW-Copilot V1 propose trois outils pour gérer les ressources MODX :
LW-Copilot/
├── mcp_server/
│ ├── main.py # Point d'entrée du serveur
│ ├── config/
│ │ ├── settings.py # Configuration (URLs, auth, etc.)
│ │ └── logger.py # Initialisation du logger
│ │
│ ├── core/
│ │ ├── errors.py # Exceptions personnalisées
│ │ ├── permissions.py # Vérification des permissions
│ │ ├── constants.py # Énumérations (ModxType, actionType)
│ │ └── context/
│ │ ├── context_manager.py # Gestion du contexte
│ │ └── context_schema.py # Schéma du contexte
│ │
│ ├── api/
│ │ └── modx_client.py # Client HTTP pour MODX
│ │
│ ├── tools/
│ │ ├── tool_class.py # Classe Tool de base
│ │ └── resource/
│ │ ├── create_resource.py # Outil create_resource
│ │ ├── get_resource.py # Outil get_resource
│ │ └── update_resource.py # Outil update_resource
│ │
│ ├── mcp/
│ │ ├── tool_exposure.py # Exposition des outils à MCP
│ │ ├── request_validator.py # Validation des requêtes
│ │ └── response_formatter.py # Formatage des réponses
│ │
│ └── tests/ # Tests unitaires
│ ├── test_context.py
│ ├── test_permissions.py
│ └── test_tools_resource.py
httpx pour les appels HTTP# Clone le repository
git clone <repo-url>
cd LW-Copilot
# Crée un virtual environment
python -m venv venv
source venv/bin/activate # ou `venv\Scripts\activate` sur Windows
# Installe les dépendances
pip install -r requirements.txt
httpx==0.24.0
python-dotenv==1.0.0
La configuration se fait via des variables d'environnement dans le fichier config/settings.py
python -m mcp_server.main
{
"tool": "create_resource",
"parameters": {
"pagetitle": "Ma nouvelle page",
"template": 1,
"content": "Contenu de la page",
"alias": "ma-nouvelle-page",
"published": true,
"tvs": {
"subtitle": "Sous-titre"
}
}
}
Crée une nouvelle ressource MODX.
Paramètres :
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| pagetitle | string | ✅ | Titre de la page |
| template | integer | ✅ | ID de la template |
| content | string | ❌ | Contenu principal |
| parent | integer | ❌ | ID du parent (défaut: 0) |
| published | boolean | ❌ | Publier la ressource |
| alias | string | ❌ | Alias URL |
| tvs | object | ❌ | Variables de template |
Exemple :
{
"tool": "create_resource",
"parameters": {
"pagetitle": "Documentation API",
"template": 2,
"content": "## Documentation\n\nCeci est la documentation...",
"alias": "api-docs",
"published": true
}
}
Récupère les données d'une ressource.
Paramètres :
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| id | integer | ✅ | ID de la ressource |
Exemple :
{
"tool": "get_resource",
"parameters": {
"id": 10
}
}
Met à jour une ressource existante.
Paramètres :
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| id | integer | ✅ | ID de la ressource |
| pagetitle | string | ❌ | Nouveau titre |
| content | string | ❌ | Nouveau contenu |
| published | boolean | ❌ | Nouveau statut publication |
| alias | string | ❌ | Nouvel alias |
| tvs | object | ❌ | Nouvelles variables de template |
Exemple :
{
"tool": "update_resource",
"parameters": {
"id": 10,
"pagetitle": "Documentation API (Mise à jour)",
"content": "## Documentation mise à jour\n\n..."
}
}
Toutes les réponses des outils suivent ce format standardisé :
{
"success": true,
"code": 200,
"data": [
{
"id": 10,
"pagetitle": "Ma page",
"template": 1,
"...": "..."
}
],
"message": "Resource created successfully"
}
Champs :
| Code | Erreur | Description |
|---|---|---|
| 400 | Validation Error | Paramètres invalides ou manquants |
| 401 | Authentication Error | Authentification échouée |
| 403 | Permission Error | Droits insuffisants |
| 404 | Not Found | Ressource non trouvée |
| 500 | Internal Error | Erreur serveur |
{
"success": false,
"code": 403,
"data": [],
"message": "Access denied: update permission not granted for resource 10"
}
Le contexte définit les ressources/templates accessibles par l'agent :
{
"resource": {
"10": { "read": true, "update": false },
"11": { "read": true, "update": true }
},
"template": {
"1": { "read": true },
"2": { "read": true }
}
}
L'agent ne peut que :
"read": true"update": true"read": trueExécute les tests unitaires :
python -m pytest mcp_server/tests/ -v
Les logs sont stockés selon la configuration LOG_LEVEL :
import logging
logger = logging.getLogger(__name__)
logger.info("Message d'information")
logger.error("Message d'erreur")
© Intersel 2026
Damien Lugagne-Delpon - damien.lugagne-delpon@livinweb.fr