AI导哈

Odoo ERP连接工具

通过XML-RPC协议将AI助手连接到Odoo ERP系统的工具，无需插件，支持TypeScript和零配置。

  • by intellieffect
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 intellieffect/odoo-mcp

使用说明

odoo mcp

Odoo ERP的MCP（模型上下文协议）服务器。使用标准XML-RPC将任何AI助手连接到您的Odoo实例-- 没有插件，没有YOLO模式，没有麻烦.

✨ 亮点

  • 无需加载项 -使用Odoo内置的XML-RPC API
  • 无YOLO模式 -正确的API密钥或用户/密码身份验证
  • TypeScript --类型齐全，可靠
  • 零配置 --与跑步 npx odoo-mcp，通过环境变量进行配置
  • 奥多14+ --适用于支持XML-RPC的任何Odoo版本

快速开始

1.获取Odoo API密钥

首选 设置→ 用户→ 用户→ 偏好→ 账户安全→ API密钥 并生成一个。

2.配置您的MCP客户端

添加到您的MCP配置中（Claude Desktop、Cursor等）：

{
  "mcpServers": {
    "odoo": {
      "command": "npx",
      "args": ["-y", "odoo-mcp"],
      "env": {
        "ODOO_URL": "https://your-odoo.com",
        "ODOO_DB": "your-db",
        "ODOO_API_KEY": "your-api-key"
      }
    }
  }
}

3.开始提问

“显示所有未结销售订单” “通过电子邮件创建一个名为John Doe的新联系人john@example.com" “本月创建了多少张发票？”

环境变量

变量 必填 描述
ODOO_URL ✅ Odoo实例URL（例如。， https://your-odoo.com)
ODOO_DB ✅ 数据库名称
ODOO_API_KEY ✅* 用于身份验证的API密钥
ODOO_USER ✅* 用户电子邮件（使用用户/密码身份验证时）
ODOO_PASSWORD ✅* 密码（使用用户/密码身份验证时）

*要么 ODOO_API_KEY 或两者 ODOO_USER + ODOO_PASSWORD 是必需的。

工具

工具 说明
search_records 使用域过滤器、字段选择、分页和排序搜索记录
read_record 按ID读取特定记录
create_record 创建新记录
update_record 更新现有记录
delete_record 删除记录
count_records 统计与域筛选器匹配的记录
list_models 列出所有可用的Odoo型号
get_fields 获取模型的字段定义

例子

搜索记录：

model: "res.partner"
domain: '[["is_company","=",true]]'
fields: "name,email,phone"
limit: 10

创建记录：

model: "res.partner"
values: '{"name":"John Doe","email":"john@example.com","is_company":false}'

获取字段信息：

model: "sale.order"
attributes: "string,type,required"

认证

API密钥（推荐）

  1. 登录您的Odoo实例
  2. 首选 设置→ 用户和公司→ Users
  3. 选择您的用户→ 偏好 标签
  4. 在...之下 账户安全，单击 新API密钥
  5. 复制密钥并将其设置为 ODOO_API_KEY

用户/密码

集 ODOO_USER （电子邮件）和 ODOO_PASSWORD 而不是 ODOO_API_KEY。这不太安全，不建议用于生产。

发展

git clone https://github.com/intellieffect/odoo-mcp.git
cd odoo-mcp
npm install
npm run build

本地测试：

ODOO_URL=https://your-odoo.com ODOO_DB=your-db ODOO_API_KEY=your-key node dist/index.js

许可证

麻省理工学院

相关 MCP