AI导哈

Dolibarr MCP服务器

为Dolibarr ERP/CRM系统提供MCP协议集成的中间件服务器，实现与AI工具和自动化系统的无缝对接。

  • by MONA-RE
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 MONA-RE/dolibarr-mcp-server

使用说明

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 <repository-url>
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服务器是使用以下指南和模板构建的： theNetworkChuck的Docker MCP教程.

非常感谢 网络Chuck 感谢您创建了一个优秀的教程和模板，使构建此MCP服务器成为可能！

许可证

MIT许可证-有关详细信息，请参阅许可证文件。

该项目是开源的，允许商业和专有使用。

参考文献

相关 MCP