dolibarr-mcp/CHANGELOG.md

Changelog

All notable changes to the Dolibarr MCP Server project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

[1.1.0] - 2025-09-24

🔥 MAJOR FIX: Windows Compatibility

• FIXED: Windows pywin32 permission issues that prevented installation
• ADDED: Standalone server implementation that works WITHOUT MCP package
• ADDED: setup_standalone.bat - Windows-optimized setup script
• ADDED: run_standalone.bat - Start standalone server
• ADDED: requirements-windows.txt - pywin32-free dependencies
• ADDED: test_standalone.py - Test script for standalone version

✨ New Features

• ADDED: Interactive testing mode in standalone server
• ADDED: Enhanced error handling with detailed API error messages
• ADDED: Professional configuration validation with helpful setup guides
• ADDED: Comprehensive German README (README_DE.md)

🛠️ Improvements

• IMPROVED: Setup process with multiple fallback options
• IMPROVED: Error messages with actionable troubleshooting steps
• IMPROVED: Documentation with Windows-specific troubleshooting
• IMPROVED: Docker configuration with health checks and resource limits

📋 Available Tools (Complete CRUD for all modules)

• ✅ System: test_connection, get_status
• ✅ Users: get_users, get_user_by_id, create_user, update_user, delete_user
• ✅ Customers: get_customers, get_customer_by_id, create_customer, update_customer, delete_customer
• ✅ Products: get_products, get_product_by_id, create_product, update_product, delete_product
• ✅ Invoices: get_invoices, get_invoice_by_id, create_invoice, update_invoice, delete_invoice
• ✅ Orders: get_orders, get_order_by_id, create_order, update_order, delete_order
• ✅ Contacts: get_contacts, get_contact_by_id, create_contact, update_contact, delete_contact
• ✅ Raw API: dolibarr_raw_api - Direct access to any Dolibarr endpoint

🐳 Docker

• ADDED: Multi-stage Dockerfile for optimized production builds
• ADDED: docker-compose.yml with health checks
• ADDED: Test service configuration for automated testing

📚 Documentation

• ADDED: Comprehensive setup instructions for Windows
• ADDED: Troubleshooting guide for common issues
• ADDED: API endpoint documentation and examples
• ADDED: Contributing guidelines

[1.0.1] - 2025-09-23

Initial Release

• ADDED: Complete Dolibarr API client with async/await
• ADDED: MCP server implementation with 30+ tools
• ADDED: Professional error handling and logging
• ADDED: Docker support with production configuration
• ADDED: Comprehensive test suite
• ADDED: Configuration management with .env support

Core Features

• Full CRUD operations for all major Dolibarr modules
• Async HTTP client with proper connection handling
• Pydantic validation for type safety
• Professional logging and error reporting
• MCP 1.0 compliance for LLM integration

Supported Dolibarr Modules

• User Management
• Customer/Third Party Management
• Product Management
• Invoice Management
• Order Management
• Contact Management
• Raw API access for extensibility

---

Installation Summary

Windows Users (RECOMMENDED)

.\setup_standalone.bat  # Avoids pywin32 issues
.\run_standalone.bat    # Start server

Linux/macOS Users

./setup.sh
python -m src.dolibarr_mcp

Docker Users

docker-compose up -d

Support

• 🐛 Issues: GitHub Issues
• 💡 Discussions: GitHub Discussions
• 📖 Wiki: Project Wiki