奥多-MCP-改进版

Name: 奥多-MCP-改进版
Author: hachecito

作者：hachecito26 星标更新：2025-07-13

安装使用来源：spider==github.com

项目介绍

技术文档摘要

Odoo MCP 改进版

演示.gif

[](https://pypi.org/project/ odoo-mcp-improved/)

增强型模型上下文协议（MCP）服务器，适用于Odoo ERP系统，提供销售、采购、库存管理和会计领域的高级工具

</div>

📋 目录

概述
功能
安装
配置
使用
工具参考
资源参考
提示
Claude桌面集成
许可证

🔍 概述

Odoo MCP 改进版是针对Odoo ERP系统的全面实现的模型上下文协议（MCP）。它提供了大型语言模型（如Claude）与您的Odoo实例之间的桥梁，使AI助手能够直接与您的业务数据和流程进行交互。

这个扩展版本增强了原始的MCP-Odoo实现，增加了销售、采购、库存管理和会计领域的高级工具和资源，使其成为AI辅助业务操作的强大解决方案。

✨ 功能

核心能力

无缝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 .

⚙️ 配置

环境变量

export ODOO_URL=https://您的Odoo实例.com
export ODOO_DB=您的数据库
export ODOO_USERNAME=您的用户名
export ODOO_PASSWORD=您的密码

配置文件

在工作目录中创建一个odoo_config.json文件：

{
  "url": "https://您的Odoo实例.com",
  "db": "您的数据库",
  "username": "您的用户名",
  "password": "您的密码"
}

🚀 使用

运行服务器

# 使用模块
python -m odoo_mcp

示例交互

# 销售分析
使用Odoo MCP分析我们上个季度的销售表现，并识别我们的畅销产品。

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

# 财务分析
根据最新的财务数据计算我们的流动性和盈利能力比率。

# 客户洞察
提供客户ABC的购买历史和付款模式的见解。

🤖 Claude桌面集成

在您的claude_desktop_config.json中添加以下内容：

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "args": ["-m", "odoo_mcp"],
      "env": {
        "ODOO_URL": "https://您的Odoo实例.com",
        "ODOO_DB": "您的数据库",
        "ODOO_USERNAME": "您的用户名",
        "ODOO_PASSWORD": "您的密码"
      }
    }
  }
}

🔠 工具参考

销售工具

工具	描述
`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 改进版包括针对不同业务场景的专用提示：

销售分析提示

销售趋势分析
客户细分
产品表现评估
销售团队表现

库存管理提示

库存优化
补货建议
仓库效率分析
产品移动模式

人力资源提示

员工规划
排班优化
绩效评估
资源分配

财务分析提示

比率解释
现金流量分析
预算差异分析
财务健康评估

📄 许可证

本项目采用MIT许可证 - 查看LICENSE文件获取详情。

此仓库是从mcp-odoo扩展而来 - Lê Anh Tuấn

Odoo MCP 改进版 - 通过全面的Odoo ERP功能赋能AI助手

</div>