Add comprehensive MCP installation fix guide

MCP_FIX_GUIDE.md

@@ -0,0 +1,148 @@
+# 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.