Wavyzz/dolibarr-mcp
1
0
Fork 0
mirror of https://github.com/latinogino/dolibarr-mcp.git synced 2026-04-30 21:35:36 +02:00
Code Issues Packages Projects Releases Wiki Activity

Add HTTP transport option for MCP server

Browse Source
This commit is contained in:
latinogino
2025-12-28 13:37:24 +01:00
parent 58882ff8c0
commit 373f4063b2
6 changed files with 152 additions and 25 deletions
Download Patch File Download Diff File Expand all files Collapse all files

22
README.md
View File

@@ -90,6 +90,9 @@ The server reads configuration from the environment or a `.env` file. Both
| `DOLIBARR_URL` / `DOLIBARR_SHOP_URL` | Base Dolibarr API endpoint, e.g. `https://example.com/api/index.php`. Trailing slashes are handled automatically. |
| `DOLIBARR_API_KEY` | Personal Dolibarr API token. |
| `LOG_LEVEL` | Optional logging verbosity (`INFO`, `DEBUG`, `WARNING`, …). |
| `MCP_TRANSPORT` | Transport to use: `stdio` (default) or `http` for streamable HTTP. |
| `MCP_HTTP_HOST` | Host/interface to bind when using HTTP transport (default `0.0.0.0`). |
| `MCP_HTTP_PORT` | Port to bind when using HTTP transport (default `8080`). |
Example `.env`:
@@ -127,8 +130,8 @@ same environment variables when launched from Linux or macOS hosts.
### Start the MCP server
The server communicates over STDIO, so run it in the foreground from the virtual
environment:
The server communicates over STDIO by default, so run it in the foreground from
the virtual environment:
```bash
python -m dolibarr_mcp.dolibarr_mcp_server
@@ -137,6 +140,20 @@ python -m dolibarr_mcp.dolibarr_mcp_server
Logs are written to stderr to avoid interfering with the MCP protocol. Keep the
process running while Claude Desktop is active.
### HTTP streaming mode (for Open WebUI or remote MCP clients)
Enable the HTTP transport by setting `MCP_TRANSPORT=http` (and optionally
`MCP_HTTP_HOST` / `MCP_HTTP_PORT`). This keeps the server running without STDIO
and exposes the Streamable HTTP transport compatible with Open WebUI:
```bash
MCP_TRANSPORT=http MCP_HTTP_PORT=8080 python -m dolibarr_mcp.dolibarr_mcp_server
```
Then point Open WebUI’s MCP configuration at `http://<host>:8080/`. The MCP
protocol headers (including `mcp-protocol-version`) are handled automatically by
Open WebUI’s MCP client.
### Test the Dolibarr credentials
Use the standalone connectivity check before wiring the server into an MCP host:
@@ -161,4 +178,3 @@ When the environment variables are already set, omit the overrides and run
## 📄 License
Released under the [MIT License](LICENSE).