odoo-pulse

odoo-pulse

为你的 Odoo ERP 提供 AI 业务分析。 提出一个问题， 即可获得一个答案——包括数据、重点、风险和结论 （进展顺利 / 存在风险 / 进展滞后）——通过 Model Context Protocol 实现。Odoo 的 CRUD 桥接工具已经存在； 这是构建于其上的分析层。

分析工具

每个工具都能通过一次调用回答一个完整的管理问题，并返回带有结论的结构化报告， 而不是一份需要你自行解读的原始数据。

工具	可回答的问题
business_pulse ⭐	晨间简报：昨日销售额、新增线索、逾期发票、延迟任务、休假人员——以及公司整体结论
pipeline_review	按阶段划分的 CRM 销售漏斗、停滞交易、加权收入、近期成交率
sales_snapshot	本期与上期收入对比（Δ%）、主要客户 / 产品、长期未更新的报价
receivables_health	AR/AP 账龄区间、逾期比例、主要欠款方
inventory_risk	短缺（预测库存为负）和滞销库存
absence_overview	本周休假人员、待审批事项、人员覆盖不足的部门
procurement_watch	采购：延迟收货、长期未更新的询价单、各供应商未结支出
production_health	制造：未按计划开始时间推进的订单、停滞的在制品
project_profitability	项目：已记录工时与分配工时、成本 / 收入 / 利润率、预算消耗结论
project_budget	逐项目、逐条目对比预算与实际支出——超出计划的条目，以及预算未涵盖的支出
team_workload · project_status_report · standup_digest	项目交付：超负荷成员、存在风险的项目和每日站会摘要

所有报告金额的工具都接受可选的 company= 筛选条件，并会标记币种混杂的总额，而不会悄悄将其相加；结论阈值 （停滞比例、逾期比例、增长比例）均可配置，因此你可以根据业务情况进行调整。

时区语义

所有报告工具都接受 timezone_offset（默认为 7）。Odoo 以 UTC 存储日期时间 字段；工具会先按 timezone_offset 小时进行偏移，再按日历日期分组，日期范围 则以 UTC 日期时间边界表示。仅日期字段（例如 project.milestone.deadline、 invoice_date_due、project.task.date_deadline）按原值进行比较。

依赖版本的字段

find_partner 仅在仍包含 mobile 字段的实例上搜索该字段（Odoo 19 已移除该字段）；如果未安装 hr_timesheet，list_timesheets 会给出可执行的错误提示。

底层使用标准的 Odoo XML-RPC 外部 API——无需在 Odoo 内安装任何内容，可用于 Odoo Online、Odoo.sh 和本地部署。需要 Odoo 18+：通用工具（search_read、read_records 等）仍可在旧版本上运行，但无法保证报告工具在这些版本上可用。

试用体验环境

没有 Odoo 账号？启动一个预置了典型案例的 Odoo 演示实例（停滞的交易、 逾期 90 天的发票、库存短缺，以及今天休假的人员）：

docker compose -f deploy/playground/compose.yml up -d

首次启动会下载约 4 GB 的镜像（Odoo + Postgres）并初始化演示数据—— 根据你的网络连接情况，请预留 5-10 分钟。然后让 Claude 连接到该实例， 并要求它 run business_pulse。完整操作指南： docs/guides/playground.md。

安装与连接

将其添加到 Claude Code（无需安装步骤 — uvx 会获取它）：

claude mcp add odoo-pulse \
  --env ODOO_URL=https://acme.odoo.com \
  --env ODOO_DB=acme \
  --env [email protected] \
  --env ODOO_API_KEY=your-api-key \
  --env ODOO_READ_ONLY=true \
  -- uvx odoo-pulse

在 Odoo 中依次打开 Settings → Users → (your user) → Account Security → New API Key，生成 API 密钥。Claude Desktop 和 Cursor 的配置，以及 pip 和 Docker 替代方案：见 docs/guides/install.md。如果 API 密钥可能已 泄露，请参阅如果 API 密钥可能已 泄露。

或者一键安装：

默认只读，需要时可安全写入

该服务开箱即为只读（ODOO_READ_ONLY=true）。写入需要同时满足四项独立控制：ODOO_READ_ONLY=false、 ODOO_WRITABLE_MODELS（以逗号分隔的模型允许列表），删除操作还需设置 ODOO_ALLOW_DELETE=true，并且每次调用都要设置 confirm=true ——否则，每个写入工具都会返回试运行预览。系统模型始终不可写。详情请见：docs/reference/tools.md#write-operations。

更多工具

除了分析报告外，还有约 60 种支持模型感知查询的工具，涵盖 CRM、 Sales、Inventory、Accounting、HR、Project、Manufacturing、PoS 和 Enterprise 应用 — 可通过 ODOO_TOOL_GROUPS 选择启用。完整目录和配置： docs/reference/tools.md。

测试

测试套件会模拟 XML-RPC 层，因此无需真实的 Odoo 或网络：

pip install -e ".[dev]"
pytest

如需对真实 Odoo 执行在线检查（只读），请参阅 docs/reference/tools.md#live-smoke-test-against-a-real-odoo。

许可证

MIT