erpipe-org/mcp-odoo

解决的问题

Odoo MCP 为 Odoo 16+（社区版和企业版）提供免费的 AI 层，使 LLM 能够在无需昂贵的企业专属 AI 功能或复杂 Odoo 端模块安装的情况下与 Odoo 数据库交互。它弥合了 AI 代理（如 Claude、GPT 和 Gemini）与 Odoo 数据之间的鸿沟，使其能够安全地执行查询、审计和受控写入操作。

工作原理

该项目作为 Model Context Protocol (MCP) 服务器运行，通过 XML-RPC（适用于 16-18 版本）或 External JSON-2（适用于 19+ 版本）连接 Odoo。它向 AI 代理公开 41 个工具，使其能够读取记录、检查模式并执行诊断。为确保安全，默认情况下禁止直接写入访问；写入操作需要经过包含审批令牌、实时元数据验证和可选人工介入确认表单的受控工作流。

适用人群

• Odoo 用户：希望免费为其 Odoo 实例添加 AI 功能的用户
• AI 代理用户：使用 Cursor 或 Claude Code 等 IDE，需要实时 Odoo 上下文的用户
• Odoo 开发者/合作伙伴：需要工具进行迁移审计、数据质量检查以及跨多个客户数据库的跨实例查询的专业人士

主要亮点

• 零 Odoo 端配置：使用现有凭据即可工作；无需应用商店模块或管理员权限
• 安全写入工作流：采用受控系统，包含审批令牌和人工介入（HITL）确认，防止意外数据损坏
• 全面的工具集：包含 41 个工具，支持读取记录、服务器端聚合、聊天集成和本地优先的 BM25 知识搜索
• 多实例支持：单个服务器可同时管理并查询多个命名的 Odoo 实例
• 高级诊断功能：提供升级风险报告、适配性分析和 Odoo 19 JSON-2 迁移助手等专用工具
• 字段级 ACL：支持按实例或按模型选择性启用字段允许/拒绝列表，以限制数据访问