MCP Odoo

🚀 Odoo MCP 服務器

Odoo MCP 服務器集成到 Odoo ERP 系統中，藉助 Model Context Protocol（模型上下文協議），讓 AI 助手能夠與 Odoo 的數據和服務進行交互，極大地拓展了系統的應用場景和功能。

🚀 快速開始

安裝

Python 包安裝

pip install odoo-mcp

Docker 構建

docker build -t mcp/odoo:latest -f Dockerfile .

運行服務器

# 使用安裝的包
odoo-mcp

# 使用 MCP 開發工具
mcp dev odoo_mcp/server.py

# 帶有額外依賴項
mcp dev odoo_mcp/server.py --with pandas --with numpy

# 掛載本地代碼進行開發
mcp dev odoo_mcp/server.py --with-editable .

✨ 主要特性

• 全面的 Odoo 集成：可完全訪問 Odoo 模型、記錄和方法。
• XML-RPC 通信：通過 XML-RPC 安全連接到 Odoo 實例。
• 靈活的配置：支持配置文件和環境變量。
• 資源模式系統：基於 URI 訪問 Odoo 數據結構。
• 錯誤處理：針對常見 Odoo API 問題提供清晰的錯誤消息。
• 無狀態操作：乾淨的請求/響應週期實現可靠集成。

📚 詳細文檔

工具

execute_method

• 功能：在 Odoo 模型上執行自定義方法。
• 輸入：
  • model（字符串）：模型名稱。
  • method（字符串）：要執行的方法名稱。
  • args（可選數組）：傳遞給方法的參數列表。
  • kwargs（可選對象）：傳遞給方法的關鍵字參數。
• 輸出：執行方法的結果。

search_employee

• 功能：搜索員工信息。
• 輸入：
  • criteria（字符串/對象）：搜索條件，支持列表格式或 JSON 對象。
  • fields（可選數組）：要返回的字段列表。
• 輸出：符合條件的員工記錄。

search_holidays

• 功能：搜索假期信息。
• 輸入：
  • date_range（字符串）：日期範圍，格式為 "YYYY-MM-DD"。
  • employee_id（可選整數）：特定員工 ID。
• 輸出：符合條件的假期記錄。

資源

• Odoo 模型：odoo://models
• Odoo 記錄：odoo://records/{model_name}/{id}
• Odoo 方法：odoo://methods/{model_name}/{method_name}

參數格式說明

在使用 MCP 工具時，請注意以下參數格式指南：

1. 領域參數：
   • 支持以下字段格式：
     • 列表格式：[["field", "operator", value], ...]
     • 對象格式：{"conditions": [{"field": "...", "operator": "...", "value": "..."}]}
     • 兩種格式的 JSON 字符串
   • 示例：
     • 列表格式：[["is_company", "=", true]]
     • 對象格式：{"conditions": [{"field": "date_order", "operator": ">=", "value": "2025-03-01"}]}
     • 多個條件：[["date_order", ">=", "2025-03-01"], ["date_order", "<=", "2025-03-31"]]
2. 字段參數：
   • 應該是字段名稱數組：["name", "email", "phone"]
   • 服務器將嘗試解析字符串輸入為 JSON

📄 許可證

此 MCP 服務器根據 MIT License（MIT）許可。