odoo-mcp

Ein MCP-Server für Odoo. Er gibt einem LLM-Agenten Lese- und Schreibzugriff auf Partner, Verkaufsaufträge, Lagerbestände und Rechnungen in einer Odoo-Instanz.

Status: früh. Die folgende Werkzeugliste ist der Plan. Noch funktioniert nicht alles.

Warum

Odoo ist ein vollständiges ERP mit einer breiten API, was es für einen Agenten schwer zu nutzen macht. Seine externe API ist XML-RPC mit generischen search_read- und execute_kw-Aufrufen, sodass der Agent Modellnamen, Feldnamen und Domänensyntax kennen müsste. Dieser Server stellt stattdessen eine kleine Anzahl benannter Werkzeuge bereit, die jeweils eine Aufgabe abdecken, die eine Person tatsächlich anfragen würde.

Odoo Community läuft in Docker mit Demodaten, sodass das Ganze ohne ein echtes System ausprobiert werden kann.

Related MCP server: MCP Server for Odoo

Werkzeuge

Schnellstart

docker compose up -d odoo db    # Odoo Community with demo data
cp .env.example .env
docker compose up mcp

Odoo benötigt etwa eine Minute, um seine Datenbank beim ersten Start zu initialisieren.

So funktioniert es

Der Server verbindet sich über XML-RPC mit Odoo. Jedes Werkzeug erstellt die Domäne und die Feldliste selbst, sodass der Agent nie Odoo-Interna sieht. Ergebnisse werden auf die relevanten Felder reduziert und als flache Datensätze zurückgegeben.

Designentscheidungen

Benannte Werkzeuge, kein generisches Abfragewerkzeug. Ein einzelnes run_query-Werkzeug wäre einfacher zu schreiben und viel schlechter zu verwenden. Benannte Werkzeuge tragen ihre eigene Validierung und machen offensichtlich, was der Agent tun darf.

Lesen und Schreiben sind getrennt. Schreibwerkzeuge sind im Schema markiert, sodass der Client eine Bestätigung verlangen kann.

Fehler werden übersetzt. Odoo wirft Fehler mit langen Tracebacks. Der Server extrahiert die Meldung und gibt sie in einer Form zurück, auf die der Agent reagieren kann.

Was noch fehlt

• Paginierung und Ergebnislimits

• Multi-Company-Unterstützung

• Tests gegen eine geseedete Odoo-Instanz

Lizenz

MIT