Serveur MCP Dolibarr

MCP Dolibarr服务器

为Dolibarr ERP/CRM提供强大的生产就绪MCP（模型上下文协议）服务器。 该服务器允许人工智能代理（如Claude Desktop、ChatGPT（通过MCP适配器）等）通过其REST API与您的Dolibarr实例安全交互。

🚀 功能

• 自主 ：独立于Dolibarr的内部代码工作。仅使用REST API。
• Stack Moderne ：使用TypeScript和Node.js LTS构建。
• 标准化 ：使用官方SDK @modelcontextprotocol/sdk.
• 为Docker做好准备 ：包括优化的Dockerfile和复合配置。
• 安全 ：按环境变量配置，无硬标识符。
• 自动富集 ：通过API自动完成法国公司的数据（SIREN、SIRET、NAF、RCS、地址） api.gouv.fr 创建时，如果地址丢失。

🛠 包括的工具

服务器公开 105+工具MCP 涵盖整个Dolibarr API：

📇 层级（第三方）

• dolibarr_get_thirdparty - dolibarr_search_thirdparties
• dolibarr_create_thirdparty - dolibarr_update_thirdparty

👤 联系人

• dolibarr_get_contact - dolibarr_list_contacts_for_thirdparty
• dolibarr_create_contact

📄 商业提案

• dolibarr_get_proposal - dolibarr_list_proposals - dolibarr_create_proposal
• dolibarr_add_proposal_line - dolibarr_update_proposal_line - dolibarr_delete_proposal_line
• dolibarr_change_proposal_status

📦 命令

• dolibarr_get_order - dolibarr_create_order - dolibarr_change_order_status

💰 裂缝

• dolibarr_get_invoice - dolibarr_list_invoices - dolibarr_create_invoice
• dolibarr_create_invoice_from_proposal - dolibarr_record_invoice_payment

🏷️ 产品/服务

• dolibarr_get_product - dolibarr_search_products

📁 文件

• dolibarr_list_documents_for_object - dolibarr_upload_document_for_object

📊 项目和任务

• dolibarr_get_project - dolibarr_list_projects - dolibarr_create_project
• dolibarr_get_task - dolibarr_create_task

👥 用户

• dolibarr_get_user - dolibarr_list_users

🏦 银行

• dolibarr_list_bank_accounts - dolibarr_get_bank_account_lines

🏭 仓库-新

• dolibarr_list_warehouses - dolibarr_get_warehouse

📦 库存-NOUVEAU

• dolibarr_list_stock_movements - dolibarr_create_stock_movement

🚚 装运-新

• dolibarr_list_shipments - dolibarr_get_shipment - dolibarr_create_shipment

📝 合同-新

• dolibarr_list_contracts - dolibarr_get_contract - dolibarr_create_contract

🎫 门票（支持）-NOUVEAU

• dolibarr_list_tickets - dolibarr_get_ticket - dolibarr_create_ticket

📅 议程-NOUVEAU

• dolibarr_list_agenda_events - dolibarr_get_agenda_event - dolibarr_create_agenda_event

💳 Notes de Frais-NOUVEAU

• dolibarr_list_expense_reports - dolibarr_get_expense_report - dolibarr_create_expense_report

🔧 干预措施（Fichinter）-新

• dolibarr_list_interventions - dolibarr_get_intervention - dolibarr_create_intervention

🔐 权限和权限-新增

• dolibarr_list_user_groups - dolibarr_create_user_group - dolibarr_add_user_to_group
• dolibarr_set_user_rights - dolibarr_get_audit_logs

🌍 多实体和货币-新

• dolibarr_list_entities - dolibarr_create_entity
• dolibarr_list_currencies - dolibarr_convert_currency

📅 日历和缺勤-新

• dolibarr_list_holidays - dolibarr_create_holiday - dolibarr_validate_holiday
• dolibarr_create_resource_booking - dolibarr_list_resource_bookings

💳 订阅-新

• dolibarr_list_subscriptions - dolibarr_create_subscription
• dolibarr_renew_subscription - dolibarr_cancel_subscription

📊 分析和仪表板-NOUVEAU

• dolibarr_get_sales_stats - dolibarr_get_top_customers
• dolibarr_get_global_status

📚 工具的完整文档 🚀 详细的高级模块

📋 先决条件

• Node.js>=18
• 功能性Dolibarr实例（v10+）
• Dolibarr API密钥（在用户设置中生成）

📦 安装

地方发展

1. 克隆存储库：

   git clone https://github.com/votre-repo/serveur-mcp-dolibarr.git
   cd serveur-mcp-dolibarr

1. 安装依赖项：

   npm install

1. 配置环境：

复制 .env.example 朝向 .env 并填写您的信息。

   cp .env.example .env

编辑 .env :

   DOLIBARR_BASE_URL=https://votre-dolibarr.com/api/index.php
   DOLIBARR_API_KEY=votre_cle_api
   LOG_LEVEL=info

1. 构建和启动：

   npm run build
   npm start

Docker部署

1. 构建图像：

   docker build -t dolibarr-mcp .

1. 使用Docker Compose启动：

   docker-compose up -d

1. 以交互方式启动（stdio模式）：

   docker run -i --env-file .env dolibarr-mcp

🤖 Claude桌面的配置

将以下内容添加到您的 claude_desktop_config.json :

通过Docker（推荐）

{
  "mcpServers": {
    "dolibarr": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "DOLIBARR_BASE_URL=https://votre-dolibarr.com/api/index.php",
        "-e", "DOLIBARR_API_KEY=votre_cle_api",
        "dolibarr-mcp"
      ]
    }
  }
}

通过Node.js本地

{
  "mcpServers": {
    "dolibarr": {
      "command": "node",
      "args": [
        "/chemin/absolu/vers/serveur-mcp-dolibarr/dist/index.js"
      ],
      "env": {
        "DOLIBARR_BASE_URL": "https://votre-dolibarr.com/api/index.php",
        "DOLIBARR_API_KEY": "votre_cle_api"
      }
    }
  }
}

🐛 调试

你可以使用 MCP检查员 倾倒测试仪。

npx @modelcontextprotocol/inspector node dist/index.js

🏗 项目结构

src/
├── server.ts           # Point d'entrée du serveur MCP
├── services/
│   ├── dolibarr.ts     # Client API REST Dolibarr
│   └── company-search.ts # Service d'enrichissement (api.gouv.fr)
├── tools/              # Définitions des outils MCP
│   ├── thirdparties.ts # Outils de gestion des tiers
│   ├── proposals.ts    # Outils de gestion des propositions
│   └── ...
├── types/              # Définitions TypeScript et Schémas Zod
└── utils/
    └── config.ts       # Configuration de l'environnement
docs/                   # Documentation détaillée
extras/                 # Scripts et outils supplémentaires
tests/                  # Tests unitaires

📚 文档

🚀 开始

• 安装
• 配置
• 快速启动

📖 参考API

• 完整的API参考 - 105+文档化工具
• MCP工具列表
• API勘探

🎯 指南和用法

• 50桶用量
• 高级模块
• 快速 启动 高级 模块

📝 变更日志和迁移

• 变更日志完成
• 版本比较
• V2.0实现摘要

🔧 兼容性

• Dolibarr API兼容性
• 项目结构

👥 作者和信用

该项目由以下人员发起和开发： 最大DION 倒 吉尔特克.

• 主要作者 ：Maxime DION
• 组织 : 吉尔特克

📜 许可证

麻省理工学院