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密钥（推荐）
- 登录您的Odoo实例
- 首选 设置→ 用户和公司→ Users
- 选择您的用户→ 偏好 标签
- 在...之下 账户安全，单击 新API密钥
- 复制密钥并将其设置为
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许可证
麻省理工学院