Serveur MCP pour exposer des outils et ressources de pilotage MODX/LWE via API REST.
|
|
5 kuukautta sitten | |
|---|---|---|
| src | 5 kuukautta sitten | |
| tests | 5 kuukautta sitten | |
| .cursorignore | 5 kuukautta sitten | |
| .env.example | 5 kuukautta sitten | |
| .gitignore | 5 kuukautta sitten | |
| README.md | 5 kuukautta sitten | |
| pyproject.toml | 5 kuukautta sitten |
Serveur MCP pour exposer des outils et ressources de pilotage MODX/LWE via API REST.
| Couche | Dossier / fichier | Rôle |
|---|---|---|
| Point d'entrée | src/main.py |
Valide la config, instancie ClientRest, lance FastMCP en transport stdio |
| Configuration | src/config/initialization.py |
Charge .env, valide BASE_URL, LWE_TOKEN, PHPSESSID |
| Protocole MCP | src/server_mcp/server.py |
Assemble le serveur et enregistre outils et ressources |
| Outils (écriture) | src/server_mcp/tools.py |
Opérations mutantes : CRUD ressources, chunks, snippets, templates, etc. |
| Ressources (lecture) | src/server_mcp/resources.py |
Opérations en lecture seule, réponses filtrées pour limiter le contexte envoyé à l'agent |
| Transport HTTP | src/services/client_rest.py |
Client synchrone httpx vers l'API distante |
mcp-server/
├── src/
│ ├── main.py # Entrée : get_settings() → build_server() → run(stdio)
│ ├── config/
│ │ └── initialization.py # Settings + validation au démarrage
│ ├── server_mcp/
│ │ ├── server.py # build_server(ClientRest)
│ │ ├── tools.py # @server.tool — mutations LWE
│ │ └── resources.py # @server.resource — lectures LWE
│ └── services/
│ └── client_rest.py # GET / POST / PUT / DELETE vers BASE_URL
├── tests/ # pytest + couverture (unitaires + intégration optionnelle)
├── .env.example
└── pyproject.toml # uv, dépendances (mcp, httpx, python-dotenv)
readOnlyHint, destructiveHint, idempotentHint) pour guider l'agent.Les deux couches partagent le même ClientRest injecté à l'assemblage du serveur, ce qui centralise l'authentification et les appels HTTP.
uv.env avec:
BASE_URLLWE_TOKENPHPSESSIDuv sync
cp .env.example .env
Remplir le fichier .env avec les variables d'environnements approriés
uv run python -m src.main
Le serveur fonctionne en transport stdio pour etre consomme par Cursor.
Dans fichier mcp.json de Cursor,
{
"mcpServers": {
"modx": {
"command": "uv run",
"args": [
"--project", "path/to/project/root",
"python", "-m",
"src.main"
],
"env": {
"PYTHONPATH": "path/to/project/root"
}
}
}
}
Un exemple de mcp.json
{
"mcpServers": {
"modx": {
"command": "uv run",
"args": [
"--project", "/home/user/khanh/mcp-server",
"python", "-m",
"src.main"
],
"env": {
"PYTHONPATH": "/home/user/khanh/mcp-server"
}
}
}
}