dolibarr-mcp-server

MONA-RE/dolibarr-mcp-server

3.2

If you are the rightful owner of dolibarr-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Dolibarr MCP Server project aims to create a Model Context Protocol server for Dolibarr, enabling seamless integration with AI and automation tools.

Dolibarr MCP Server

Objectif

Ce projet vise à créer un serveur MCP (Model Context Protocol) pour Dolibarr, permettant une intégration transparente avec des outils d'IA et d'automatisation. Le serveur MCP expose les fonctionnalités de Dolibarr via ses API REST et les rend accessibles via le protocole MCP.

Architecture

Ce serveur MCP s'appuie sur le module docker-mcp-gateway pour fournir une interface standardisée entre les clients MCP et l'API REST de Dolibarr.

Composants

  • Dolibarr API: API REST native de Dolibarr exposant les fonctionnalités de gestion (projets, tâches, tiers, etc.)
  • docker-mcp-gateway: Module gateway permettant d'exposer les API via le protocole MCP
  • MCP Server: Serveur implémentant le protocole MCP pour Dolibarr

Fonctionnalités

Le serveur MCP permet d'interagir avec Dolibarr pour:

  • Gérer les projets (création, modification, suppression, consultation)
  • Gérer les tâches associées aux projets
  • Consulter et gérer les tiers (clients, fournisseurs)
  • Accéder aux autres modules Dolibarr via leur API

Documentation

Documentation API Dolibarr

La documentation complète des API Dolibarr est disponible dans le dossier :

Authentification

L'API Dolibarr utilise une clé API (DOLAPIKEY) pour l'authentification. Cette clé doit être générée depuis l'interface Dolibarr et configurée dans le serveur MCP.

Prérequis

  • Docker et Docker Compose
  • Une instance Dolibarr fonctionnelle avec le module API/Web Services activé
  • Module docker-mcp-gateway

Installation

# Cloner le repository
git clone <repository-url>
cd dolibarr-mcp-server

# Configuration (à venir)
# ...

# Lancement du serveur MCP (à venir)
# ...

Configuration

Le serveur MCP nécessite les paramètres suivants:

  • DOLIBARR_URL: URL de base de votre instance Dolibarr
  • DOLIBARR_API_KEY: Clé API générée depuis Dolibarr

Utilisation

Avec Claude Code

Le projet inclut un fichier .mcp.json pour une utilisation directe dans Claude Code :

# 1. Construire les images Docker
cd mcp-server-projects && docker build -t dolibarr-projects-mcp-server:latest .
cd ../mcp-server-tasks && docker build -t dolibarr-tasks-mcp-server:latest .

# 2. Configurer les variables d'environnement
cp .env.example .env
# Éditer .env avec vos valeurs

# 3. Ouvrir le projet dans Claude Code
# Les serveurs MCP seront automatiquement disponibles

Consultez pour plus de détails.

Avec Claude Desktop

Le projet inclut une configuration complète pour Claude Desktop :

# Utiliser le script d'installation
cd mcp-config
./install.sh

Consultez pour plus de détails.

Structure du projet

dolibarr-mcp-server/
├── .mcp.json                      # Configuration MCP pour Claude Code
├── .env.example                   # Exemple de variables d'environnement
├── README.md                      # Ce fichier
├── CLAUDE_CODE.md                 # Guide d'utilisation avec Claude Code
├── Dolibarr_api_documentation/    # Documentation des API Dolibarr
│   ├── README.md
│   ├── projects.md                # API Projects
│   ├── tasks.md                   # API Tasks
│   ├── thirdparties.md           # API Tiers
│   ├── contacts.md               # API Contacts
│   ├── invoices.md               # API Factures
│   └── products.md               # API Produits
├── mcp-server/                    # Serveur MCP Projects
│   ├── Dockerfile
│   ├── dolibarr_projects_server.py
│   ├── requirements.txt
│   ├── README.md
│   └── CLAUDE.md
├── mcp-server-tasks/              # Serveur MCP Tasks
│   ├── Dockerfile
│   ├── dolibarr_tasks_server.py
│   ├── requirements.txt
│   ├── README.md
│   └── CLAUDE.md
├── mcp-config/                    # Configuration pour Claude Desktop
│   ├── custom.yaml               # Catalogue MCP
│   ├── registry.yaml             # Registre MCP
│   ├── install.sh                # Script d'installation
│   └── README.md
└── prompt/                        # Prompts et instructions
    ├── prompt-api-documentation.md
    └── mcp-builder-prompt-mcp-dolibarr-task.md

Roadmap

  • Implémentation du serveur MCP de base
  • Support de l'API Projects (6 outils)
  • Support de l'API Tasks (4 outils)
  • Documentation complète des API Dolibarr
    • Projects API
    • Tasks API
    • Thirdparties API
    • Contacts API
    • Invoices API
    • Products/Services API
  • Documentation complète d'utilisation
    • Guide Claude Code
    • Guide Claude Desktop
    • Scripts d'installation
  • Configuration partageable pour contributeurs
  • Support de l'API Thirdparties (serveur MCP)
  • Support de l'API Contacts (serveur MCP)
  • Support de l'API Invoices (serveur MCP)
  • Support de l'API Products/Services (serveur MCP)
  • Tests d'intégration automatisés
  • CI/CD avec GitHub Actions

Contribuer

Les contributions sont les bienvenues! N'hésitez pas à ouvrir des issues ou des pull requests.

Remerciements

Ce serveur MCP a été construit en utilisant le guide et le template de theNetworkChuck's Docker MCP Tutorial.

Un grand merci à NetworkChuck pour avoir créé un excellent tutoriel et un template qui ont rendu possible la construction de ce serveur MCP !

Licence

MIT License - Voir le fichier LICENSE pour plus de détails.

Ce projet est open source et permet une utilisation commerciale et propriétaire.

Références