Serveur MCP pour exposer des outils et ressources de pilotage MODX/LWE via API REST.

Khanh Nguyen d28ef36684 update tool parametres name пре 4 месеци
src d28ef36684 update tool parametres name пре 4 месеци
tests d28ef36684 update tool parametres name пре 4 месеци
.cursorignore 7b5055669b update tool and client rest to fix delete resource error пре 5 месеци
.env.example 237dd86418 initialize mcp server пре 5 месеци
.gitignore a8997c2f98 update fixed libraries пре 5 месеци
README.md 330720a990 update README пре 5 месеци
pyproject.toml a8997c2f98 update fixed libraries пре 5 месеци
uv.lock a8997c2f98 update fixed libraries пре 5 месеци

README.md

LW MCP Server

Serveur MCP pour exposer des outils et ressources de pilotage MODX/LWE via API REST.

Architecture du projet

Rôles des modules

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

Arborescence

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)

Séparation outils / ressources

  • Ressources MCP : exposent des données en lecture (liste ou détail de ressources MODX, etc.) avec un filtrage par liste blanche de champs.
  • Outils MCP : exposent des actions (création, mise à jour, suppression) avec des annotations (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.

Prerequis

  • Python 3.13+
  • uv
  • Un fichier .env avec:
    • BASE_URL
    • LWE_TOKEN
    • PHPSESSID

Installation

uv sync
cp .env.example .env

Remplir le fichier .env avec les variables d'environnements approriés

Execution

uv run lw-mcp-server

Le serveur fonctionne en transport stdio pour etre consomme par Cursor.

Intégration en 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"
      ]
    }
  }
}