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 的购买历史和付款模式洞察。

📚 详细文档

工具参考

销售工具

| 工具 | 描述 | |------|-------------| | search_sales_orders | 高级筛选搜索销售订单 | | create_sales_order | 创建新的销售订单 | | analyze_sales_performance | 按时间段、产品或客户分析销售业绩 | | get_customer_insights | 获取特定客户的详细洞察 |

采购工具

| 工具 | 描述 | |------|-------------| | search_purchase_orders | 高级筛选搜索采购订单 | | create_purchase_order | 创建新的采购订单 | | analyze_supplier_performance | 分析供应商绩效指标 |

库存工具

| 工具 | 描述 | |------|-------------| | check_product_availability | 检查产品的库存可用性 | | create_inventory_adjustment | 创建库存调整记录 | | analyze_inventory_turnover | 计算和分析库存周转率指标 |

会计工具

| 工具 | 描述 | |------|-------------| | search_journal_entries | 搜索会计日记账分录 | | create_journal_entry | 创建新的日记账分录 | | analyze_financial_ratios | 计算关键财务比率 |

资源参考

销售资源

| URI | 描述 | |-----|-------------| | odoo://sales/orders | 列出销售订单 | | odoo://sales/order/{order_id} | 获取特定销售订单的详细信息 | | odoo://sales/products | 列出可销售产品 | | odoo://sales/customers | 列出客户 |

采购资源

| URI | 描述 | |-----|-------------| | odoo://purchase/orders | 列出采购订单 | | odoo://purchase/order/{order_id} | 获取特定采购订单的详细信息 | | odoo://purchase/suppliers | 列出供应商 |

库存资源

| URI | 描述 | |-----|-------------| | odoo://inventory/products | 列出库存中的产品 | | odoo://inventory/stock/{location_id} | 获取特定位置的库存水平 | | odoo://inventory/movements | 列出库存移动记录 |

会计资源

| URI | 描述 | |-----|-------------| | odoo://accounting/accounts | 列出会计账户 | | odoo://accounting/journal_entries | 列出日记账分录 | | odoo://accounting/reports/{report_type} | 获取财务报告 |

提示

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