erpipe-org/mcp-odoo

解決的問題

Odoo MCP 為 Odoo 16+（社區版與企業版）提供免費的 AI 層，讓 LLM 能在不需要昂貴企業專用 AI 功能或複雜 Odoo 端模組安裝的情況下與 Odoo 資料庫互動。它彌合了 AI 代理（如 Claude、GPT 和 Gemini）與 Odoo 資料之間的差距，使其能安全地執行查詢、審計與受控寫入操作。

工作原理

此專案作為 Model Context Protocol (MCP) 伺服器運作，透過 XML-RPC（適用於 16-18 版本）或 External JSON-2（適用於 19+ 版本）連接 Odoo。它向 AI 代理公開 41 個工具，使其能讀取記錄、檢查模式並執行診斷。為確保安全，預設禁止直接寫入存取；寫入操作需經過包含審批金鑰、即時元資料驗證與可選人工介入確認表單的受控工作流程。

適用對象

• Odoo 使用者：希望免費為其 Odoo 實例新增 AI 功能的使用者
• AI 代理使用者：使用 Cursor 或 Claude Code 等 IDE，需要即時 Odoo 上下文的使用者
• Odoo 開發者／合作夥伴：需要工具進行遷移審計、資料品質檢查以及跨多個客戶資料庫的跨實例查詢的專業人士

主要亮點

• 零 Odoo 端設定：使用現有憑證即可運作；無需應用商店模組或管理員權限
• 安全寫入工作流程：採用受控系統，包含審批金鑰與人工介入（HITL）確認，防止意外資料損壞
• 全面的工具集：包含 41 個工具，支援讀取記錄、伺服器端聚合、聊天整合與本地優先的 BM25 知識搜尋
• 多實例支援：單一伺服器可同時管理並查詢多個命名的 Odoo 實例
• 高階診斷功能：提供升級風險報告、適配性分析與 Odoo 19 JSON-2 迁移助手等專用工具
• 欄位層級 ACL：支援按實例或按模型選擇性啟用欄位允許/拒絕清單，以限制資料存取