Odoo 的 MCP 服务器

Odoo 的模型上下文协议 (MCP) 服务器实现。此软件包允许 AI 模型通过标准化的 MCP 接口与 Odoo 数据和功能进行交互，从而使像 Claude 这样的 AI 助手能够搜索、检索并最终操作 Odoo 数据。

功能

• 通过标准化的接口将 Odoo 数据公开为 MCP 资源
• 具有域过滤器和复杂查询的搜索功能
• 用于大型数据集的分页和摘要
• 针对 LLM 消费优化的 Odoo 数据的智能格式化
• 通过 URI 逐步公开数据以进行详细访问
• 遵循现有的 Odoo 权限模型和安全约束
• 通过环境变量或 CLI 参数轻松配置
• 未指定时自动检测默认数据库

安装

pip install mcp-server-odoo
# 或
uv install mcp-server-odoo

配置

使用环境变量配置 MCP 服务器：

• ODOO_URL: 您的 Odoo 实例的 URL
• ODOO_DB: 数据库名称（可选 - 如果未指定，将自动检测）
• ODOO_MCP_TOKEN: 来自 Odoo MCP 模块的身份验证令牌
• ODOO_USERNAME: Odoo 用户名
• ODOO_PASSWORD: Odoo 密码
• ODOO_MCP_LOG_LEVEL: 日志记录级别（DEBUG、INFO、WARNING、ERROR、CRITICAL）
• ODOO_MCP_DEFAULT_LIMIT: 默认记录限制（默认值：50）
• ODOO_MCP_MAX_LIMIT: 允许的最大记录限制（默认值：100）

或使用命令行参数：

mcp-server-odoo --url https://example.odoo.com --token abc123

身份验证

MCP 服务器支持两种身份验证方法：

1. 基于令牌的身份验证（推荐）：

   • 在 Odoo MCP 模块设置中生成令牌
   • 在环境变量中设置令牌或使用 --token 参数
   • 安全并维护来自 Odoo 的用户权限

2. 用户名/密码身份验证：

   • 当令牌身份验证不可用时使用
   • 使用 ODOO_USERNAME 和 ODOO_PASSWORD 环境变量指定

通过 MCP 服务器的所有操作都继承经过身份验证的 Odoo 用户的权限，并遵守现有的 Odoo 安全约束。

数据库自动检测

如果未提供 ODOO_DB 环境变量或 --db 参数，服务器将尝试自动检测 Odoo 实例的默认数据库。 这对于单数据库 Odoo 安装特别有用。

自动检测过程：

1. 尝试查询数据库列表端点 (/web/database/list)
2. 如果失败，尝试从登录页面提取数据库

如果自动检测失败，您需要显式指定数据库。

资源 URI 格式

Odoo MCP 服务器对资源使用以下 URI 格式：

odoo://{model}/{operation}?{parameters}

操作

• record/{id} - 获取特定记录
• search - 使用域搜索记录
• browse - 按 ID 检索多个记录
• count - 计算匹配的记录
• fields - 获取字段定义

参数

• domain - Odoo 域表达式（URL 编码）
• fields - 要返回的字段的逗号分隔列表
• limit - 要返回的最大记录数
• offset - 分页偏移量
• order - 排序标准

示例 URI

odoo://res.partner/record/42
odoo://product.product/search?domain=[('type','=','product')]&limit=10
odoo://sale.order/browse?ids=1,2,3,4
odoo://res.partner/count?domain=[('country_id.code','=','US')]
odoo://product.template/fields

数据表示

资源以人类可读的文本格式返回，针对 LLM 消费进行了优化：

Resource: res.partner/record/42
Name: Deco Addict
Email: deco.addict82@example.com
Phone: +1 555-123-4567
Address:
  Street: 77 Santa Barbara Rd
  City: Pleasant Hill
  ZIP: 94523
  Country: United States
Related Contacts: [odoo://res.partner/search?domain=[('parent_id','=',42)]]
Recent Orders: [odoo://sale.order/search?domain=[('partner_id','=',42)]&limit=5]

对于大型数据集，提供智能摘要：

Search Results: res.partner (1247 total matches)
Showing: Records 1-15 of 1247
Summary:
- Customer type: 923 companies, 324 individuals
- By country: US (412), France (287), Germany (203), Other (345)
- Active status: 1198 active, 49 archived

Records:
1. Deco Addict (Company) - US, Active [odoo://res.partner/record/1]
...

Refinement options:
- Filter by country: odoo://res.partner/search?domain=[('country_id.code','=','US')]
- Next page: odoo://res.partner/search?offset=15&limit=15

与 Claude 桌面应用程序一起使用

添加到您的 mcp.conf：

{
  "odoo": {
    "command": "mcp-server-odoo",
    "args": []
  }
}

为了进行更多自定义，您可以使用环境变量：

{
  "odoo": {
    "command": "mcp-server-odoo",
    "args": [],
    "env": {
      "ODOO_URL": "https://example.odoo.com",
      "ODOO_DB": "mydb",
      "ODOO_MCP_TOKEN": "abc123"
    }
  }
}

示例 AI 助手交互

配置完成后，您可以使用自然语言与您的 Odoo 实例进行交互。 以下是一些示例：

基本信息检索

• "查找上个月在加利福尼亚州购买了东西的所有客户"
• "显示本季度销量排名前 5 的产品"
• "发票 INV/2023/00423 的付款状态是什么？"

复杂数据分析

• "总结我们 2023 年第一季度按地区的销售业绩"
• "比较所有仓库的库存水平"
• "显示过去 6 个月未订购的客户"

上下文跟进

• "其中有多少在技术领域？"
• "哪个具有最高的终身价值？"
• "你能给我更多关于这个客户的细节吗？"

AI 助手会将这些自然语言查询转换为适当的 MCP 资源请求，以检索和呈现相关信息。

开发

# 克隆存储库
git clone https://github.com/ivnvxd/mcp-server-odoo.git
cd mcp-server-odoo

# 安装开发依赖项
pip install -e ".[dev]"

# 运行测试
pytest

# 使用 MCP Inspector 运行开发服务器
mcp dev mcp_server_odoo

# 在 Claude Desktop 中安装服务器
mcp install mcp_server_odoo

Odoo 模块集成

此 Python 包旨在与 mcp_server Odoo 模块一起使用。 完整的系统由两个组件组成：

1. Odoo 模块 (mcp_server)

   • 安装在 Odoo 环境中
   • 处理配置和安全设置
   • 管理模型访问权限
   • 为 Python 包提供身份验证令牌

2. Python 包 (mcp-server-odoo)

   • 此包 - 实现 MCP 协议
   • 通过 XML-RPC 连接到 Odoo
   • 使用 stdio 传输进行 MCP 客户端通信
   • 处理资源格式化和分页

集成流程

┌─────────────────┐      ┌─────────────────────┐       ┌──────────────────┐
│                 │      │                     │       │                  │
│   MCP Client    │◄────►│   mcp-server-odoo   │◄─────►│   Odoo Instance  │
│  (Claude/etc)   │ stdio│   (Python Package)  │XML-RPC│  with mcp_server │
│                 │      │                     │       │                  │
└─────────────────┘      └─────────────────────┘       └──────────────────┘

在使用此 Python 包之前，必须在您的 Odoo 实例中安装 Odoo 模块。 有关安装和配置 Odoo 模块的信息，请参阅 mcp_server 模块文档。

支持

感谢您使用这个项目！ 如果您觉得它有帮助并想支持我的工作，请考虑请我喝咖啡。 您的支持将不胜感激！

<a href="https://www.buymeacoffee.com/ivnvxd" target="_blank"><img src="https://cdn.buymeacoffee.com/buttons/v2/default-yellow.png" alt="Buy Me A Coffee" style="height: 60px !important;width: 217px !important;" ></a>

如果您喜欢这个项目，请不要忘记给它一个星星！ :star:

许可证

此源代码形式受 Mozilla Public License, v. 2.0 条款的约束。 如果此文件中未分发 MPL 的副本，您可以在 http://mozilla.org/MPL/2.0/ 获取一份。

有关详细信息，请参见 LICENSE 文件。