odoo-mcp

Odoo 用の MCP サーバーです。LLM エージェントに、Odoo インスタンス内のパートナー、販売注文、在庫レベル、請求書への読み書きアクセスを提供します。

ステータス: 初期段階です。以下のツールリストは計画です。まだすべてが動作するわけではありません。

なぜ

Odoo はフル機能の ERP であり、API が広範なため、エージェントが使用するのは困難です。外部 API は XML-RPC で、汎用的な search_read や execute_kw 呼び出しを使用するため、エージェントはモデル名、フィールド名、ドメイン構文を知っている必要があります。このサーバーは、代わりに少数の名前付きツールを公開し、それぞれが人が実際に要求するタスクをカバーします。

Odoo Community は Docker でデモデータとともに実行されるため、実際のシステムなしで全体を試すことができます。

Related MCP server: MCP Server for Odoo

ツール

クイックスタート

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

Odoo は初回起動時にデータベースの初期化に約 1 分かかります。

仕組み

サーバーは XML-RPC を介して Odoo に接続します。各ツールはドメインとフィールドリストを自身で構築するため、エージェントが Odoo の内部構造を見ることはありません。結果は重要なフィールドに絞られ、フラットなレコードとして返されます。

設計上の決定

汎用クエリツールではなく、名前付きツール。 単一の run_query ツールは記述が簡単ですが、使用ははるかに劣ります。名前付きツールは独自の検証を備え、エージェントが何を許可されているかを明確にします。

読み取りと書き込みは分離されています。 書き込みツールはスキーマでマークされているため、クライアントは確認を要求できます。

エラーは変換されます。 Odoo は長いトレースバックを持つ障害を発生させます。サーバーはメッセージを抽出し、エージェントが対応できる形式で返します。

まだ実装されていないもの

• ページネーションと結果の制限

• マルチカンパニー対応

• シードされた Odoo インスタンスに対するテスト

ライセンス

MIT