Odoo ERP集成服务器

Odoo MCP Server是一个连接AI代理(如Claude)与Odoo ERP实例的标准服务器,允许AI通过自然语言在Odoo中搜索、读取、写入和执行工作流。

  • by zorguiala
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 zorguiala/Odoo-MCP

使用说明

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:地方发展

  1. 克隆 这个仓库。
  2. 安装和构建: npm install && npm run build
  3. 使用:把克劳德指给当地人 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单元创建一次性物料清单…”