Dolibarr MCP服务器
目标
该项目旨在为Dolibarr创建一个模型上下文协议(MCP)服务器,实现与人工智能和自动化工具的无缝集成。MCP服务器通过其REST API公开Dolibarr的功能,并通过MCP协议提供这些功能。
建筑
此MCP服务器依赖于模块 docker mcp网关 提供MCP客户端和Dolibarr REST API之间的标准化接口。
组件
- API Dolibarr公司:Dolibarr本地REST API,公开管理功能(项目、任务、第三方等)
- docker mcp网关:通过MCP协议公开API的网关模块
- MCP服务器:为Dolibarr实现MCP协议的服务器
功能
MCP服务器允许您与Dolibarr交互:
- 管理项目(创建、修改、删除、咨询)
- 管理与项目相关的任务
- 咨询和管理第三方(客户、供应商)
- 通过API访问其他Dolibarr模块
文档
API Dolibarr文件
Dolibarr API的完整文档可在文件夹中找到 Dolibarr_api_documentation/:
认证
Dolibarr API使用API密钥(dolapikey)进行身份验证。该密钥必须从Dolibarr接口生成并在MCP服务器中配置。
先决条件
- Docker与Docker编写
- 启用API/Web服务模块的Dolibarr实例
- 模块docker mcp网关
安装
# Cloner le repository
git clone
cd dolibarr-mcp-server
# Configuration (à venir)
# ...
# Lancement du serveur MCP (à venir)
# ...配置
MCP服务器需要以下参数:
- Dolibarr URL:Dolibarr实例的基本URL
- Dolibarr API密钥:从Dolibarr生成的API密钥
使用
饰Claude Code
该项目包括一个文件 .mcp.json 要在Claude代码中直接使用:
# 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查看 CLAUDE_CODE.md 更多详情。
与Claude Desktop
该项目包括Claude桌面的完整配置:
# Utiliser le script d'installation
cd mcp-config
./install.sh查看 mcp配置/README.md 更多详情。
项目结构
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路线图
- \[x\]基本MCP服务器的实现
- \[x\]项目API支持(6个工具)
- \[x\]任务API支持(4个工具)
- \[x\]Dolibarr API的完整文档
- \[x\] API项目 - \[x\] 任务API - \[x\] 第三方API - \[x\] 联系方式API - \[x\] 发票API - \[x\] 产品/服务API
- \[x\]完整的使用文档
- \[x\] 克劳德代码指南 - \[x\] 克劳德桌面指南 - \[x\] 安装脚本
- \[x\]贡献者的可共享配置
- \[\]第三方API支持(MCP服务器)
- \[\]联系人API支持(MCP服务器)
- \[\]发票API支持(MCP服务器)
- \[\]产品/服务API支持(MCP服务器)
- \[\]自动化集成测试
- \[\]带GitHub操作的CI/CD
贡献者
欢迎捐款!不要犹豫打开问题或拉取请求。
致谢
此MCP服务器是使用以下指南和模板构建的: .
非常感谢 网络Chuck 感谢您创建了一个优秀的教程和模板,使构建此MCP服务器成为可能!
许可证
MIT许可证-有关详细信息,请参阅许可证文件。
该项目是开源的,允许商业和专有使用。
参考文献
-
