Odoo Assistant MCP

🚀 Odoo MCP Server

通过自然英语与你的Odoo ERP进行交互，借助MCP服务器将Claude连接到你的Odoo实例，实现自然对话式的数据查询、记录创建和工作流构建。

🚀 快速开始

将以下内容添加到你项目的 .mcp.json 文件中：

{
  "mcpServers": {
    "odoo": {
      "command": "npx",
      "args": ["odoo-mcp"],
      "env": {
        "ODOO_URL": "https://your-instance.odoo.com",
        "ODOO_DB": "your_database",
        "ODOO_USERNAME": "your_username",
        "ODOO_PASSWORD": "your_api_key"
      }
    }
  }
}

启动Claude Code，即可完成连接。

✨ 主要特性

• 自然语言交互：无需API语法、字段查找或在众多模型中搜索，只需用自然语言描述需求，例如 "Draft invoices for all outstanding timesheets for Acme Inc"。
• 自然语言标准操作流程（SOP）：完成复杂任务后，可将其保存为SOP。团队成员只需说出相应的SOP名称，即可重复执行相同步骤，实现知识的有效传承。
• 强大的数据操作能力：
  • 查询任意数据：可查询合作伙伴、发票、产品、库存水平等Odoo的500多个模型的数据。
  • 创建和更新记录：支持创建和更新发票、订单、联系人、日记账分录等记录。
  • 批量操作：具备批量导入数据的功能，并能处理错误。
• 知识共享：将 .odoo-mcp/ 提交到git，团队成员可立即学习和使用。

📚 详细文档

• 用户指南：包含自然语言SOP的强大功能、配置选项、SOP库的构建以及故障排除等完整指南。
• 示例SOP：提供了可直接使用的模板，帮助你快速上手。

📦 安装指南

要求

• 启用XML - RPC（默认）的Odoo 14+版本。
• API密钥（仅自定义计划可用，One App Free或Standard版本不可用）。
• Node.js 18+。

测试版本

所有99个集成测试均在持续集成（CI）中针对每个版本运行。

🔗 相关链接

• 用户指南
• 示例SOP
• Odoo外部API
• 模型上下文协议

📄 许可证

本项目采用MIT许可证。