|
|
3 bulan lalu | |
|---|---|---|
| .cursor | 4 bulan lalu | |
| src | 3 bulan lalu | |
| .cursorignore | 4 bulan lalu | |
| .env.example | 3 bulan lalu | |
| .gitignore | 4 bulan lalu | |
| AGENT.md | 4 bulan lalu | |
| README.md | 4 bulan lalu | |
| main.py | 4 bulan lalu | |
| pyproject.toml | 4 bulan lalu | |
| uv.lock | 4 bulan lalu |
Serveur Model Context Protocol (MCP) en Python pour OilApp, l'application de suivi des anomalies documentaires (OIL aéronautique) hébergée sur Livinweb Engine.
Il agit comme passerelle entre un assistant IA (Cursor en V0) et l'API REST OilApp : l'agent dialogue en langage naturel, le serveur MCP traduit les intentions en requêtes HTTP authentifiées.
PHPSESSID) pour un utilisateur autoriségit clone <url-du-depot>
cd oilapp-mcp
uv sync
Copiez le fichier d'exemple et renseignez vos identifiants :
cp .env.example .env
| Variable | Obligatoire | Description |
|---|---|---|
BASE_URL |
Oui | URL racine de l'API REST OilApp (ex. https://api.site.local) |
PHPSESSID |
Oui | Cookie de session PHP de l'utilisateur connecté |
AUTHORIZATION |
Non | Jeton d'authentification complémentaire, si requis par l'API |
Le fichier .env est exclu du contrôle de version (.gitignore) et de l'indexation Cursor (.cursorignore). Ne commitez jamais de secrets.
Sans .env valide, le serveur refuse de démarrer et indique les variables manquantes.
uv run oilapp-mcp
Équivalent :
uv run python main.py
Le serveur communique en stdio (JSON-RPC 2.0), comme attendu par les clients MCP.
Le dépôt inclut une configuration MCP dans .cursor/mcp.json :
{
"mcpServers": {
"oilapp": {
"command": "uv",
"args": ["run", "oilapp-mcp"]
}
}
}
Après configuration et redémarrage de Cursor, le serveur oilapp apparaît dans les outils MCP. Vous pouvez alors demander en langage naturel, par exemple :
Consultez AGENT.md pour les règles de comportement de l'agent et les particularités de l'API.
| Outil | Description | Méthode REST |
|---|---|---|
create_finding |
Crée un finding | POST /rest/oilapp-findings/finding/ |
get_findings |
Recherche des findings | GET /rest/oilapp-findings/findings |
get_finding_stats |
Statistiques des findings | GET /rest/oilapp-stats/findingstats |
Les paramètres de chaque outil sont documentés via des champs Pydantic Field(description=...) et exposés au client MCP dans le schéma JSON.
| URI | Description | Point REST |
|---|---|---|
oilapp://finding/{id} |
Détail d'un finding | GET /rest/oilapp-findings/finding |
oilapp://projects |
Projets accessibles | GET /rest/oilapp-projects/projects |
oilapp://items/{id} |
Items d'un projet | GET /rest/oilapp-items/items |
oilapp-mcp/
├── main.py # Point d'entrée
├── pyproject.toml # Dépendances et script oilapp-mcp
├── .env.example # Modèle de configuration
├── AGENT.md # Règles de l'agent IA
├── concept.md # Conception technique
├── spec.md # Spécification détaillée
└── src/
├── config/
│ └── initialization.py # Chargement .env, validation, démarrage
├── services/
│ └── client_rest.py # Client HTTP httpx (singleton)
└── mcp/
├── engine.py # Instance FastMCP
├── tools.py # Outils MCP
└── resources.py # Ressources MCP
PHPSESSID (et éventuellement Authorization).Dépendances principales :
mcp[cli] — SDK Python MCP (FastMCP)httpx — client HTTP synchronepython-dotenv — chargement des variables d'environnementPour inspecter le serveur en mode développement MCP :
uv run mcp dev main.py