Odoo MCP 服务器

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

功能

• 全面的Odoo集成：完全访问Odoo模型、记录和方法
• XML-RPC通信：通过XML-RPC安全连接到Odoo实例
• 灵活的配置：支持配置文件和环境变量
• 资源模式系统：基于URI访问Odoo数据结构
• 错误处理：针对常见Odoo API问题提供清晰的错误信息
• 无状态操作：干净的请求/响应循环以确保可靠集成

工具

• execute_method

  • 在Odoo模型上执行自定义方法
  • 输入参数：
    • model (字符串)：模型名称（例如，'res.partner'）
    • method (字符串)：要执行的方法名称
    • args (可选数组)：位置参数
    • kwargs (可选对象)：关键字参数
  • 返回值：包含方法结果和成功指示符的字典

• search_employee

  • 按姓名搜索员工
  • 输入参数：
    • name (字符串)：要搜索的姓名（或部分姓名）
    • limit (可选数字)：返回的最大结果数（默认20）
  • 返回值：包含成功指示符、匹配的员工姓名和ID列表以及任何错误消息的对象

• search_holidays

  • 在指定日期范围内搜索假期
  • 输入参数：
    • start_date (字符串)：YYYY-MM-DD格式的开始日期
    • end_date (字符串)：YYYY-MM-DD格式的结束日期
    • employee_id (可选数字)：用于过滤假期的可选员工ID
  • 返回值：包含成功指示符、找到的假期列表以及任何错误消息的对象

资源

• odoo://models

  • 列出Odoo系统中所有可用的模型
  • 返回值：包含模型信息的JSON数组

• odoo://model/{model_name}

  • 获取特定模型的信息，包括字段
  • 示例：odoo://model/res.partner
  • 返回值：包含模型元数据和字段定义的JSON对象

• odoo://record/{model_name}/{record_id}

  • 根据ID获取特定记录
  • 示例：odoo://record/res.partner/1
  • 返回值：包含记录数据的JSON对象

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

  • 搜索符合域条件的记录
  • 示例：odoo://search/res.partner/[["is_company","=",true]]
  • 返回值：默认限制为10条的匹配记录的JSON数组

配置

Odoo连接设置

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

{
  "url": "https://your-odoo-instance.com",
  "db": "your-database-name",
  "username": "your-username",
  "password": "your-password-or-api-key"
}

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中添加以下内容：

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "args": [
        "-m",
        "odoo_mcp"
      ],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_DB": "your-database-name",
        "ODOO_USERNAME": "your-username",
        "ODOO_PASSWORD": "your-password-or-api-key"
      }
    }
  }
}

Docker

{
  "mcpServers": {
    "odoo": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "ODOO_URL",
        "-e",
        "ODOO_DB",
        "-e",
        "ODOO_USERNAME",
        "-e",
        "ODOO_PASSWORD",
        "mcp/odoo"
      ],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_DB": "your-database-name",
        "ODOO_USERNAME": "your-username",
        "ODOO_PASSWORD": "your-password-or-api-key"
      }
    }
  }
}

安装

Python包

pip install odoo-mcp

运行服务器

# 使用已安装的包
odoo-mcp

# 使用MCP开发工具
mcp dev odoo_mcp/server.py

# 带有额外依赖项
mcp dev odoo_mcp/server.py --with pandas --with numpy

# 挂载本地代码进行开发
mcp dev odoo_mcp/server.py --with-editable .

构建

Docker构建：

docker build -t mcp/odoo:latest -f Dockerfile .

参数格式指南

在使用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许可证。