跳转至

Odoo Tools — 简介

MCP-Odoo-Tools 是一个 Claude Code / Cowork 插件，通过单次安装统一访问 Odoo：一个 MCP 服务器（主要接口）和一个 备用 CLI。它支持 Odoo Community、Enterprise 和 online (SaaS)，从 第 10 版到第 19 版， 这得益于一个兼容层，它能自动解析在不同版本之间发生变化的模型名和字段名。

它由 Transgenia 构建并维护，Transgenia 是 Anthropic 注册合作伙伴（Registered 层级）。这是一个独立的开源项目，采用 MIT 许可证 ——它不是 Anthropic 的认证产品或第一方产品，也尚未在官方插件目录中获得批准。

它解决什么问题

Odoo 的模型名和字段名 在不同版本之间会变化：

  • account.invoice 在 v13 中改为了 account.move。
  • 分析字段在 v16 中发生了变化 （analytic_account_id → analytic_distribution）。
  • 包裹模型在接近 v19 时发生了变化。
  • API keys 在 /jsonrpc 上的行为在 v17 中发生了变化。

此外，Enterprise 包含 Community 所没有的模型。对于一个 AI 智能体而言， 这些差异中的每一个都是一个静默的故障点：它调用了旧名称，ERP 返回错误， 而智能体无法分辨这究竟是权限问题、网络问题还是版本问题。

本插件将这些差异吸收在 一个稳定的工具接口 之后， 让你无需为每个版本分叉你的代码。

两个接口

接口 何时使用 要求
MCP 服务器（推荐） 从 Claude Code/Cowork 的常规使用：18 个工具 + 完整兼容层 uv/uvx（自带 Python）或 Python 3.11+
备用 CLI 当你无法运行 MCP 服务器时，或用于脚本的批量访问 Node.js 18+

范围（公开 vs. 私有）

这是 公开的通用核心：只与 Odoo 通信，别无其他。任何本地化引擎、治理引擎或 客户专属功能（各国的电子发票、审批流程、备份、文档 AI）都被 有意排除 在本仓库之外，作为 Transgenia 受监督实施的一部分提供。

下一步

继续阅读 安装，或直接跳到有引导的 快速开始。

实施支持

需要帮助把它连接到你的 Odoo，或需要一个定制的 AI/ERP 集成？Transgenia 提供 AI 与 Odoo 的实施服务。 欢迎写信给我们：dev@transgenia.org。