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