Odoo MCP Improved

🚀 Odoo MCP 增強版

Odoo MCP 增強版為 Odoo ERP 系統提供了全面的 模型上下文協議（MCP） 實現。它在大型語言模型（如 Claude）和 Odoo 實例之間搭建了橋樑，讓 AI 助手能夠直接與業務數據和流程進行交互。此擴展版本在原 MCP - Odoo 實現的基礎上，增加了用於銷售、採購、庫存管理和會計的高級工具和資源，是 AI 輔助業務運營的強大解決方案。

🚀 快速開始

安裝

使用 pip

pip install odoo-mcp-improved

從源代碼安裝

git clone https://github.com/hachecito/odoo-mcp-improved.git
cd odoo-mcp-improved
pip install -e .

使用 Docker

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

配置

環境變量

export ODOO_URL=https://your-odoo-instance.com
export ODOO_DB=your_database
export ODOO_USERNAME=your_username
export ODOO_PASSWORD=your_password

配置文件

在工作目錄中創建一個 odoo_config.json 文件：

{
  "url": "https://your-odoo-instance.com",
  "db": "your_database",
  "username": "your_username",
  "password": "your_password"
}

運行服務器

使用模塊

python -m odoo_mcp

使用 Docker

docker run -i --rm \
  -e ODOO_URL=https://your-odoo-instance.com \
  -e ODOO_DB=your_database \
  -e ODOO_USERNAME=your_username \
  -e ODOO_PASSWORD=your_password \
  yourusername/odoo-mcp-improved

✨ 主要特性

核心功能

• 與 Odoo 無縫集成：通過 XML - RPC 直接連接到您的 Odoo 實例。
• 全面的數據訪問：可跨所有 Odoo 模塊查詢和操作數據。
• 模塊化架構：易於通過新工具和資源進行擴展。
• 強大的錯誤處理：提供清晰的錯誤消息和驗證，確保可靠運行。

業務領域支持

• 銷售管理：訂單跟蹤、客戶洞察和績效分析。
• 採購管理：供應商管理、訂單處理和績效指標。
• 庫存管理：庫存監控、庫存調整和週轉率分析。
• 會計：財務報告、日記賬分錄和比率分析。

高級功能

• 分析工具：具備跨所有業務領域的商業智能功能。
• 專業提示：針對常見業務場景預配置的提示。
• 資源 URI：通過 URI 模式標準化訪問 Odoo 數據。
• 性能優化：採用緩存和高效的數據檢索機制。

📦 安裝指南

使用 pip

pip install odoo-mcp-improved

從源代碼安裝

git clone https://github.com/hachecito/odoo-mcp-improved.git
cd odoo-mcp-improved
pip install -e .

使用 Docker

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

💻 使用示例

基礎用法

# 銷售分析
使用 Odoo MCP 分析上一季度的銷售業績，並確定暢銷產品。

# 庫存檢查
檢查所有倉庫中產品 XYZ 的當前庫存水平。

# 財務分析
根據最新財務數據計算當前的流動性和盈利能力比率。

# 客戶洞察
提供客戶 ABC 的購買歷史和付款模式洞察。

📚 詳細文檔

工具參考

銷售工具

採購工具

庫存工具

會計工具

資源參考

銷售資源

採購資源

庫存資源

會計資源

提示

Odoo MCP 增強版包含針對不同業務場景的專業提示：

銷售分析提示

• 銷售趨勢分析
• 客戶細分
• 產品績效評估
• 銷售團隊績效

庫存管理提示

• 庫存優化
• 補貨建議
• 倉庫效率分析
• 產品移動模式

人力資源提示

• 人員規劃
• 排班優化
• 績效評估
• 資源分配

財務分析提示

• 比率解讀
• 現金流分析
• 預算差異分析
• 財務健康評估

Docker 支持

使用 Docker 運行

docker run -i --rm \
  -e ODOO_URL=https://your-odoo-instance.com \
  -e ODOO_DB=your_database \
  -e ODOO_USERNAME=your_username \
  -e ODOO_PASSWORD=your_password \
  yourusername/odoo-mcp-improved

Docker Compose

version: '3'

services:
  odoo-mcp-improved:
    image: yourusername/odoo-mcp-improved:latest
    environment:
      - ODOO_URL=https://your-odoo-instance.com
      - ODOO_DB=your_database
      - ODOO_USERNAME=your_username
      - ODOO_PASSWORD=your_password

Claude 桌面集成

非 Docker 方式

在 claude_desktop_config.json 中添加以下內容：

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "args": ["-m", "odoo_mcp"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_DB": "your_database",
        "ODOO_USERNAME": "your_username",
        "ODOO_PASSWORD": "your_password"
      }
    }
  }
}

Docker 方式

{
  "mcpServers": {
    "odoo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e", "ODOO_URL",
        "-e", "ODOO_DB",
        "-e", "ODOO_USERNAME",
        "-e", "ODOO_PASSWORD",
        "yourusername/odoo-mcp-improved"
      ],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_DB": "your_database",
        "ODOO_USERNAME": "your_username",
        "ODOO_PASSWORD": "your_password"
      }
    }
  }
}

📄 許可證

本項目採用 MIT 許可證 - 詳情請參閱 LICENSE 文件。

本倉庫基於 mcp - odoo 擴展而來 - Lê Anh Tuấn