ivnvxd/mcp-server-odoo

解決する課題

このプロジェクトは、AIアシスタント（Claudeなど）がOdoo ERPシステムと直接対話できるようにするModel Context Protocol（MCP）サーバーを提供します。これにより、ユーザーはOdooのインターフェースを操作する代わりに、自然言語を使用して顧客、製品、請求書などのビジネスデータを管理できます。

仕組み

このサーバーは、AIクライアントとOdooインスタンスの間のブリッジとして機能します。APIキーまたはユーザー名/パスワード認証を介して接続し、2つの主要な動作モードをサポートしています：

• 標準モード：本番環境向けのセキュリティと、アクセス可能なモデルに対するきめ細かなアクセス制御のために、Odooサーバーに専用のOdoo MCPモジュールのインストールが必要です。
• YOLOモード：MCPモジュールとセキュリティ制御をバイパスして、OdooのXML-RPCまたはJSON-2 APIに直接接続する開発/テストモードで、迅速なプロトタイピングを可能にします。

stdio（デスクトップアプリ用）やstreamable-http（リモート接続用）など、複数のトランスポートプロトコルをサポートしています。

対象者

Odoo ERPを使用しており、ビジネス運用をAIを活用したワークフローに統合したいと考えているビジネスユーザーと開発者向けです。自然言語によるクエリとデータ管理が可能になります。

主な特長

• 完全なCRUD機能：Odooレコードの検索、取得、作成、更新、削除。
• サーバーサイド集計：生データを転送せずにグループ化、合計、カウントを実行。
• ワークフローアクション：オプトインのエスケープハッチを介して、公開ビジネスメソッド（例：請求書の転記）を呼び出す機能。
• スマートフィールド選択：特定のモデルに最も関連性の高いフィールドを自動的に識別して返し、LLM出力を最適化。
• リソースアクセス：リソースURIを介してバイナリファイル、画像、ドキュメントを取得。
• マルチカンパニーサポート：マルチカンパニーのOdoo環境で特定の会社に操作をスコープ。