Odoo Assistant MCP

🚀 Odoo MCP Server

通過自然英語與你的Odoo ERP進行交互，藉助MCP服務器將Claude連接到你的Odoo實例，實現自然對話式的數據查詢、記錄創建和工作流構建。

🚀 快速開始

將以下內容添加到你項目的 .mcp.json 文件中：

{
  "mcpServers": {
    "odoo": {
      "command": "npx",
      "args": ["odoo-mcp"],
      "env": {
        "ODOO_URL": "https://your-instance.odoo.com",
        "ODOO_DB": "your_database",
        "ODOO_USERNAME": "your_username",
        "ODOO_PASSWORD": "your_api_key"
      }
    }
  }
}

啟動Claude Code，即可完成連接。

✨ 主要特性

• 自然語言交互：無需API語法、字段查找或在眾多模型中搜索，只需用自然語言描述需求，例如 "Draft invoices for all outstanding timesheets for Acme Inc"。
• 自然語言標準操作流程（SOP）：完成複雜任務後，可將其保存為SOP。團隊成員只需說出相應的SOP名稱，即可重複執行相同步驟，實現知識的有效傳承。
• 強大的數據操作能力：
  • 查詢任意數據：可查詢合作伙伴、發票、產品、庫存水平等Odoo的500多個模型的數據。
  • 創建和更新記錄：支持創建和更新發票、訂單、聯繫人、日記賬分錄等記錄。
  • 批量操作：具備批量導入數據的功能，並能處理錯誤。
• 知識共享：將 .odoo-mcp/ 提交到git，團隊成員可立即學習和使用。

📚 詳細文檔

• 用戶指南：包含自然語言SOP的強大功能、配置選項、SOP庫的構建以及故障排除等完整指南。
• 示例SOP：提供了可直接使用的模板，幫助你快速上手。

📦 安裝指南

要求

• 啟用XML - RPC（默認）的Odoo 14+版本。
• API密鑰（僅自定義計劃可用，One App Free或Standard版本不可用）。
• Node.js 18+。

測試版本

所有99個集成測試均在持續集成（CI）中針對每個版本運行。

🔗 相關鏈接

• 用戶指南
• 示例SOP
• Odoo外部API
• 模型上下文協議

📄 許可證

本項目採用MIT許可證。