mirror of
https://github.com/latinogino/dolibarr-mcp.git
synced 2026-04-12 05:45:35 +02:00
149 lines
3.3 KiB
Markdown
149 lines
3.3 KiB
Markdown
# MCP Server Installation Fix Guide
|
|
|
|
## Quick Fix (Recommended)
|
|
|
|
If you're experiencing the "ModuleNotFoundError: No module named 'dolibarr_mcp'" error, follow these steps:
|
|
|
|
### Step 1: Run Diagnostic Tool
|
|
```bash
|
|
python diagnose_and_fix.py
|
|
```
|
|
This will automatically identify and fix most issues.
|
|
|
|
### Step 2: Run Installation Fix
|
|
```bash
|
|
fix_installation.bat
|
|
```
|
|
This ensures the package is properly installed.
|
|
|
|
### Step 3: Test the Server
|
|
```bash
|
|
python mcp_server_launcher.py
|
|
```
|
|
|
|
## Manual Fix Steps
|
|
|
|
If the automatic fixes don't work:
|
|
|
|
### 1. Ensure You're in the Right Directory
|
|
```bash
|
|
cd C:\Users\[YOUR_USERNAME]\GitHub\dolibarr-mcp
|
|
```
|
|
|
|
### 2. Create/Activate Virtual Environment
|
|
```bash
|
|
python -m venv venv_dolibarr
|
|
venv_dolibarr\Scripts\activate
|
|
```
|
|
|
|
### 3. Install Package in Development Mode
|
|
```bash
|
|
pip install -e .
|
|
```
|
|
|
|
### 4. Install Required Dependencies
|
|
```bash
|
|
pip install requests python-dotenv mcp
|
|
```
|
|
|
|
### 5. Configure Environment
|
|
Create a `.env` file with your Dolibarr credentials:
|
|
```
|
|
DOLIBARR_URL=https://your-dolibarr.com/api/index.php
|
|
DOLIBARR_API_KEY=your-api-key-here
|
|
```
|
|
|
|
### 6. Update Claude Desktop Configuration
|
|
|
|
Edit `%APPDATA%\Claude\claude_desktop_config.json`:
|
|
|
|
```json
|
|
{
|
|
"mcpServers": {
|
|
"dolibarr-python": {
|
|
"command": "C:\\Users\\[YOUR_USERNAME]\\GitHub\\dolibarr-mcp\\venv_dolibarr\\Scripts\\python.exe",
|
|
"args": [
|
|
"C:\\Users\\[YOUR_USERNAME]\\GitHub\\dolibarr-mcp\\mcp_server_launcher.py"
|
|
]
|
|
}
|
|
}
|
|
}
|
|
```
|
|
|
|
## Common Issues and Solutions
|
|
|
|
### Issue: ModuleNotFoundError
|
|
**Solution**: The package isn't installed. Run:
|
|
```bash
|
|
pip install -e .
|
|
```
|
|
|
|
### Issue: ImportError for dependencies
|
|
**Solution**: Install missing dependencies:
|
|
```bash
|
|
pip install requests python-dotenv mcp aiohttp pydantic
|
|
```
|
|
|
|
### Issue: Server starts but immediately stops
|
|
**Solution**: Check your `.env` file has valid credentials
|
|
|
|
### Issue: "No module named 'src'"
|
|
**Solution**: You're running from wrong directory. Navigate to project root:
|
|
```bash
|
|
cd C:\Users\[YOUR_USERNAME]\GitHub\dolibarr-mcp
|
|
```
|
|
|
|
## Testing the Installation
|
|
|
|
### Test 1: Check Module Import
|
|
```bash
|
|
python -c "from src.dolibarr_mcp import __version__; print(f'Version: {__version__}')"
|
|
```
|
|
|
|
### Test 2: Run Server Directly
|
|
```bash
|
|
python src/dolibarr_mcp/dolibarr_mcp_server.py
|
|
```
|
|
|
|
### Test 3: Check MCP Connection
|
|
```bash
|
|
python test_connection.py
|
|
```
|
|
|
|
## File Structure Verification
|
|
|
|
Ensure these files exist:
|
|
```
|
|
dolibarr-mcp/
|
|
├── src/
|
|
│ └── dolibarr_mcp/
|
|
│ ├── __init__.py
|
|
│ ├── __main__.py
|
|
│ ├── dolibarr_mcp_server.py
|
|
│ ├── dolibarr_client.py
|
|
│ └── config.py
|
|
├── .env (with your credentials)
|
|
├── setup.py
|
|
├── pyproject.toml
|
|
├── mcp_server_launcher.py
|
|
├── diagnose_and_fix.py
|
|
└── fix_installation.bat
|
|
```
|
|
|
|
## Support
|
|
|
|
If you continue to experience issues:
|
|
1. Run `diagnose_and_fix.py` and share the output
|
|
2. Check the [GitHub Issues](https://github.com/latinogino/dolibarr-mcp/issues)
|
|
3. Ensure you have Python 3.8+ installed
|
|
4. Try the alternative ultra-simple server: `python src/dolibarr_mcp/ultra_simple_server.py`
|
|
|
|
## Alternative: Docker Installation
|
|
|
|
If local installation continues to fail, use Docker:
|
|
```bash
|
|
docker-compose up
|
|
```
|
|
|
|
This will run the server in an isolated container with all dependencies pre-configured.
|