使用说明
Odoo MCP服务器
一个标准的MCP服务器,将您的AI代理(如Claude)连接到您的Odoo ERP实例。这允许AI使用自然语言在Odoo中搜索、读取、写入和执行工作流。
特性
- 核心Odoo运营:
search_read,write,create,inspect_model. - 销售工作流程:
odoo_sales_create_van_load(仓库->货车转运)。 - 制造工作流程:
odoo_mrp_create_custom_bom(动态BOM生成)。 - 安全:使用带有环境变量配置的XML-RPC。
安装
先决条件
- Node.js(v18或更高版本)
- Odoo实例(建议使用v14+)
选项1:直接使用(通过npx)
即将登陆npm!发布后,您可以使用:
{
"mcpServers": {
"odoo": {
"command": "npx",
"args": ["-y", "@zorgui/odoo-mcp"],
"env": { ... }
}
}
}
选项2:从Git安装(推荐)
由于该软件包托管在GitHub上,您可以直接全局安装:
npm install -g git+https://github.com/zorguiala/Odoo-MCP.git
然后配置Claude Desktop:
{
"mcpServers": {
"odoo": {
"command": "odoo-mcp",
"env": { ... }
}
}
}
方案3:地方发展
- 克隆 这个仓库。
- 安装和构建:
npm install && npm run build - 使用:把克劳德指给当地人
dist/index.js.
配置
创建一个 .env 根目录中的文件(或直接配置MCP客户端环境变量):
ODOO_URL=https://your-odoo-instance.com
ODOO_DB=your-database-name
ODOO_USERNAME=your-username
ODOO_PASSWORD=your-api-key-or-password
使用Claude Desktop
将以下内容添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"odoo": {
"command": "node",
"args": ["/path/to/odoo-mcp/dist/index.js"],
"env": {
"ODOO_URL": "https://your-odoo-instance.com",
"ODOO_DB": "your-database-name",
"ODOO_USERNAME": "your-username", // Use User ID or Email
"ODOO_PASSWORD": "your-password" // Use API Key if using 2FA
}
}
}
}
可用工具
- odoo_search_read:搜索记录并阅读特定字段。
- 示例:“在美国寻找合作伙伴。”
- odoo_write:更新记录。
- 示例:“更新合作伙伴ID 5的电子邮件。”
- odoo_create:创建新记录。
- 示例:“创建一个名为John Doe的新联系人。”
- odoo_inspect_model:查看模型的字段以了解其结构。
- 示例:“给我看看库存拣选区。”
- odoo_sales_create_van_load:为货车销售创建内部转账。
- 示例:“将50个产品X装载到代理Y的货车位置。”
- odoo_mrp_create_custom_bom:为生产订单创建动态/自定义BOM。
- 示例:“使用这些组件为100个产品Z单元创建一次性物料清单…”