odoo-mcp-improved - 为Odoo ERP系统提供AI集成，含多业务领域先进工具的MCP服务器

探索

Odoo MCP Improved

Odoo MCP改进版是一个增强的模型上下文协议服务器，为Odoo ERP系统提供全面的AI集成解决方案，包含销售、采购、库存和会计等业务领域的先进工具。

电子商务与零售金融 #Odoo集成 #AI助手 #业务工具 #ERP扩展 .Python

评分 : 2.5分

下载量 : 9.9K

更新时间 : 2025-07-23

打开站点

什么是Odoo MCP Improved？

Odoo MCP Improved是一个增强的模型上下文协议(MCP)服务器，专为Odoo ERP系统设计。它使AI助手能够直接与您的业务数据和流程交互，提供销售、采购、库存和会计领域的深度支持。

如何使用Odoo MCP Improved？

通过安装和配置该服务器，您可以将其连接到Odoo实例，并使用预定义的工具和资源与Odoo系统进行交互。用户可以通过简单的提示词或命令与系统进行互动。

适用场景

适用于需要AI辅助处理销售、采购、库存管理和财务分析的企业。特别适合希望提高业务效率并实现自动化操作的组织。

主要功能

Odoo集成

无缝连接Odoo ERP系统，允许AI助手访问和操作数据。

全面的数据访问

支持查询和管理所有Odoo模块中的数据。

模块化架构

易于扩展的新工具和资源，满足不同业务需求。

强大的错误处理

提供清晰的错误信息和验证，确保可靠运行。

业务领域支持

专注于销售、采购、库存管理和会计等核心业务领域。

高级功能

包括分析工具、专用提示词和标准化资源URI。

优势

提升业务操作效率，减少人工干预

提供实时数据分析和洞察

支持多种业务领域，如销售、采购、库存和会计

局限性

需要一定的技术知识进行配置和维护

对Odoo系统的依赖性较强

可能需要额外的资源来支持高性能操作

如何使用

安装

使用pip安装Odoo MCP Improved包，或者从源代码构建。

配置

设置环境变量或创建配置文件，指定Odoo实例的连接信息。

启动服务器

运行Odoo MCP Improved服务器，使其准备好接收AI助手的请求。

使用

通过简单提示词或命令与Odoo系统进行交互，获取所需的信息或执行操作。

使用案例

销售分析

分析最近季度的销售表现，识别畅销产品。

库存检查

检查产品XYZ在所有仓库中的当前库存水平。

财务分析

基于最新财务数据计算流动性比率和盈利能力指标。

客户洞察

提供客户ABC的购买历史和支付模式的见解。

常见问题

Odoo MCP Improved需要哪些前提条件？

如何解决Odoo连接问题？

Odoo MCP Improved可以与其他AI助手集成吗？

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"
      }
    }
  }
}