odoo-mcp
Docker-First FastMCP-Server für Odoo 19 JSON-2-Integrationen.
Die Laufzeitumgebung stellt eine gemeinsame Server-Factory bereit, die sowohl für stdio- als auch für HTTP-Transporte verwendet wird. Odoo-spezifische Tools können sich bei dieser Factory über odoo_mcp.tools.register_tools(server, config) oder ein kompatibles Registry-Modul registrieren.
Schnellstart
Kopieren Sie die Umgebungsvorlage:
cp .env.example .envBearbeiten Sie
.envmit Ihrem Odoo-Endpunkt und Ihren Anmeldedaten.Starten Sie den HTTP-Server:
docker compose up --buildÜberprüfen Sie die lokale Bereitschaft:
docker compose exec odoo-mcp uv run --no-sync odoo-mcp healthcheck
Der Standard-MCP-Endpunkt ist http://localhost:8000/mcp.
Related MCP server: MCP Odoo Bridge Server
Laufzeitbefehle
Ausführung über stdio für MCP-Clients, die den Serverprozess direkt starten:
odoo-mcp stdioAusführung über HTTP:
odoo-mcp http --host 0.0.0.0 --port 8000 --path /mcpBereinigte Konfiguration prüfen, ohne Geheimnisse preiszugeben:
odoo-mcp inspect-configLokale Prozessbereitschaft prüfen, ohne Odoo zu kontaktieren:
odoo-mcp healthcheckKonfiguration
Variable | Zweck |
| Basis-URL für Odoo JSON-2-Aufrufe. Erforderlich für Odoo-API-Tools. |
| Optionaler Odoo-Datenbankname. |
| Optionaler Odoo-Benutzername. |
| Optionales Odoo-Passwort. Wird durch |
| Optionaler Odoo-API-Schlüssel. Wird durch |
| Optionales Geheimnis für zukünftige HTTP-Authentifizierungs-Middleware. Wird durch |
| HTTP-Bind-Host. Standard ist |
| HTTP-Bind-Port. Standard ist |
| HTTP-Endpunkt-Pfad. Standard ist |
| Uvicorn-Log-Level. Standard ist |
Entwicklung
Installieren und führen Sie Tests mit uv aus:
uv sync
uv run pytestStatische Prüfungen, die von CI verwendet werden:
uv run ruff check .
uv run mypyDocker ist der Ziel-Bereitstellungspfad, aber lokales Docker ist für Unit-Tests nicht erforderlich. Der Docker-Healthcheck verwendet odoo-mcp healthcheck, was die Verkabelung des Serverprozesses validiert, ohne externe Netzwerkaufrufe zu tätigen.
Integrationspunkte
Die gemeinsame Factory ist odoo_mcp.server.build_server(). Sie registriert immer ein lokales healthcheck-Tool und versucht dann, die Tool-Registrierung von folgenden Orten zu importieren:
odoo_mcp.tools.register_toolsodoo_mcp.tools.registry.register_toolsodoo_mcp.tools.odoo.register_tools
Kompatible Funktionen können entweder (server) oder (server, config) akzeptieren. Dies soll es ermöglichen, den Odoo-Client, das Schema und die Tool-Worker unabhängig voneinander zu implementieren, ohne die Laufzeit-Einstiegspunkte zu ändern.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Tools
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/plgonzalezrx8/odoo-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server
