Odoo MCP 服务器

与 Odoo ERP 系统集成的 MCP 服务器实现，使 AI 助手能够通过模型上下文协议与 Odoo 数据和功能进行交互。

特征

• 全面的 Odoo 集成：完全访问 Odoo 模型、记录和方法

• XML-RPC 通信：通过 XML-RPC 安全连接到 Odoo 实例

• 灵活配置：支持配置文件和环境变量

• 资源模式系统：基于 URI 访问 Odoo 数据结构

• 错误处理：清除常见 Odoo API 问题的错误消息

• 无状态操作：清晰的请求/响应周期，实现可靠的集成

工具

• 执行方法

  • 在 Odoo 模型上执行自定义方法

  • 输入：

    • model （字符串）：模型名称（例如，“res.partner”）

    • method （字符串）：要执行的方法名称

    • args （可选数组）：位置参数

    • kwargs （可选对象）：关键字参数

  • 返回：包含方法结果和成功指示的字典

• 搜索员工

  • 按姓名搜索员工

  • 输入：

    • name （字符串）：要搜索的名称（或名称的一部分）

    • limit （可选数字）：返回的最大结果数（默认为 20）

  • 返回：包含成功指示符、匹配员工姓名和 ID 的列表以及任何错误消息的对象

• 搜索假期

  • 搜索指定日期范围内的假期

  • 输入：

    • start_date （字符串）：YYYY-MM-DD 格式的开始日期

    • end_date （字符串）：结束日期，格式为 YYYY-MM-DD

    • employee_id （可选数字）：用于筛选假期的可选员工 ID

  • 返回：包含成功指示符、找到的假期列表和任何错误消息的对象

资源

• odoo://模型

  • 列出 Odoo 系统中所有可用的模型

  • 返回：模型信息的 JSON 数组

• odoo://模型/{模型名称}

  • 获取有关特定模型（包括字段）的信息

  • 例如： odoo://model/res.partner

  • 返回：带有模型元数据和字段定义的 JSON 对象

• odoo://record/{模型名称}/{record_id}

  • 通过ID获取特定记录

  • 例如： odoo://record/res.partner/1

  • 返回：带有记录数据的 JSON 对象

• odoo://search/{model_name}/{domain}

  • 搜索与域名匹配的记录

  • 例如： odoo://search/res.partner/[["is_company","=",true]]

  • 返回：匹配记录的 JSON 数组（默认限制为 10 条）

配置

Odoo 连接设置

1. 创建一个名为odoo_config.json的配置文件：

2. 或者，使用环境变量：

   • ODOO_URL ：您的 Odoo 服务器 URL

   • ODOO_DB ：数据库名称

   • ODOO_USERNAME ：登录用户名

   • ODOO_PASSWORD ：密码或 API 密钥

   • ODOO_TIMEOUT ：连接超时（秒）（默认值：30）

   • ODOO_VERIFY_SSL ：是否验证 SSL 证书（默认值：true）

   • HTTP_PROXY ：强制 ODOO 连接使用 HTTP 代理

与 Claude Desktop 一起使用

将其添加到您的claude_desktop_config.json中：

Docker

安装

Python 包

运行服务器

建造

Docker 构建：

参数格式指南

使用 Odoo 的 MCP 工具时，请注意以下参数格式指南：

1. 域参数：

   • 支持以下域格式：

     • 列表格式： [["field", "operator", value], ...]

     • 对象格式： {"conditions": [{"field": "...", "operator": "...", "value": "..."}]}

     • 任意格式的 JSON 字符串

   • 例子：

     • 列表格式： [["is_company", "=", true]]

     • 对象格式： {"conditions": [{"field": "date_order", "operator": ">=", "value": "2025-03-01"}]}

     • 多个条件： [["date_order", ">=", "2025-03-01"], ["date_order", "<=", "2025-03-31"]]

2. 字段参数：

   • 应该是字段名称的数组： ["name", "email", "phone"]

   • 服务器将尝试将字符串输入解析为 JSON

执照

此 MCP 服务器根据 MIT 许可证获得许可。