Serveur MCP pour exposer des outils et ressources de pilotage MODX/LWE via API REST.
|
|
4 mēneši atpakaļ | |
|---|---|---|
| src | 4 mēneši atpakaļ | |
| tests | 4 mēneši atpakaļ | |
| .cursorignore | 5 mēneši atpakaļ | |
| .env.example | 5 mēneši atpakaļ | |
| .gitignore | 5 mēneši atpakaļ | |
| README.md | 5 mēneši atpakaļ | |
| pyproject.toml | 5 mēneši atpakaļ | |
| uv.lock | 5 mēneši atpakaļ |
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 lw-mcp-server
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",
"lw-mcp-server"
]
}
}
}
Un exemple de mcp.json
{
"mcpServers": {
"modx": {
"command": "uv run",
"args": [
"--project", "/home/user/ags/mcp-server",
"lw-mcp-server"
]
}
}
}