erpgent-mcp

Serveur MCP (Model Context Protocol) qui connecte un agent IA à l'ERP Dolibarr via son API REST. Construit pour ErpGent, un SaaS multi-tenant qui permet de piloter Dolibarr en langage naturel.

Architecture

Le serveur est stateless et multi-tenant : les credentials Dolibarr (dolibarr_url, api_key) de chaque client sont transmis à chaque appel d'outil, jamais stockés côté serveur MCP. Un seul déploiement peut donc servir un nombre illimité de tenants.

Client MCP (agent IA)
  → POST /tool  { tool_name, params, dolibarr_url, api_key }
    → dolibarr_mcp résout l'outil dans TOOL_REGISTRY
      → Appel API REST Dolibarr du tenant (DOLAPIKEY: {api_key})
    ← Résultat JSON
  ← { result, error }

Related MCP server: MCP Server for Odoo

Outils disponibles

Couverture CRUD sur les entités principales de Dolibarr : factures, devis, commandes, tiers (clients/fournisseurs/prospects), produits/stocks, commandes fournisseurs, comptes bancaires et rapprochement, documents GED. Voir dolibarr_mcp/tools.py pour le détail des outils et leurs paramètres.

Installation

pip install -r requirements.txt

Configuration

Les credentials Dolibarr (dolibarr_url, api_key) ne sont pas des variables d'environnement : ils sont fournis dans le corps de chaque requête /tool, ce qui permet de servir plusieurs tenants Dolibarr avec un seul serveur.

Lancer le serveur

python -m dolibarr_mcp

Ou avec Docker :

docker build -t erpgent-mcp .
docker run -d -p 8001:8001 -e MCP_SERVER_SECRET=your-secret erpgent-mcp

Utilisation

curl -X POST http://localhost:8001/tool \
  -H "Content-Type: application/json" \
  -H "x-mcp-secret: your-secret" \
  -d '{
    "tool_name": "get_invoices",
    "params": {"status": "1", "limit": 10},
    "dolibarr_url": "https://your-dolibarr.example.com/api/index.php",
    "api_key": "YOUR_DOLIBARR_API_KEY"
  }'

Tests

pytest

Déploiement

Le projet inclut une configuration Railway (railway.toml) et un Dockerfile prêts à l'emploi.

Licence

Ce code est publié à des fins de consultation uniquement. Usage commercial, modification et redistribution sont interdits sans autorisation écrite — voir LICENSE pour le détail.

Pour toute demande de licence commerciale ou de partenariat, contactez waro.ia.tech@gmail.com.