mcp-odoo

概述

此MCP服务器通过XML-RPC或External JSON-2协议连接到任何Odoo 16+数据库，提供全面的Odoo功能访问，同时通过其安全写入模型保持安全性。它包含24种工具，用于读取记录、聚合数据、诊断问题、在Odoo版本间迁移和审计模块。该服务器具有智能字段选择、服务器端聚合和聊天集成功能，专为需要真实Odoo上下文但又不想进行直接写入操作的本地代理、IDE和自动化工具而设计。

试试问 AI

装完之后，这里有 6 个你可以让 AI 做的事：

• list_models

  List Odoo model technical names and labels.

  试试:List all available models in the Odoo database.
• get_model_fields

  Read field metadata for one model.

  试试:Show me all fields for the sale.order model.
• search_records

  Run bounded read-only search_read with smart field selection.

  试试:Find all unpaid invoices from customers in Spain.
• read_record

  Read one record by model and ID with smart field selection.

  试试:Show me details for product ID 42.
• aggregate_records

  Server-side groupby/aggregation via read_group or formatted_read_group.

  试试:Group sales orders by state and count them.
• search_employee

  Search employees by name.

  试试:Find all employees named John.
• preview_write

  Produce a non-executing approval payload for create, write, or unlink.

  试试:Show me what would happen if I create a new customer.
• validate_write

  Validate a write payload against trusted live metadata.

  试试:Check if this proposed customer update is valid.
• execute_approved_write

  Execute a validated write when writes are enabled.

  试试:Create the new customer after preview.
• diagnose_odoo_call

  Diagnose a model call without executing it.

  试试:Diagnose why this search query isn't working.
• generate_json2_payload

  Convert XML-RPC input into JSON-2 endpoint and body.

  试试:Convert this XML-RPC call to JSON-2 format.
• health_check

  Report non-secret MCP runtime posture.

  试试:Check if the Odoo MCP server is running properly.

可对比工具

安装

uvx odoo-mcp --health

pip install odoo-mcp
# 或：pipx install odoo-mcp

git clone https://github.com/tuanle96/mcp-odoo.git
cd mcp-odoo
uv sync --extra dev

export ODOO_URL="https://your-odoo-instance.com"
export ODOO_DB="your-database"
export ODOO_USERNAME="your-user"
export ODOO_PASSWORD="your-password-or-api-key"
export ODOO_TRANSPORT="xmlrpc"

odoo-mcp

{
  "mcpServers": {
    "odoo": {
      "command": "odoo-mcp",
      "args": []
    }
  }
}

FAQ

支持哪些Odoo版本？

Odoo MCP支持Odoo 16-19版本，默认使用XML-RPC作为传输协议，Odoo 19+可使用External JSON-2作为选项。它已准备好支持Odoo 20。

使用此服务器是否需要在Odoo中进行特殊设置？

不需要 - 该服务器使用您当前的凭据与任何现有的Odoo 16+实例一起工作。不需要安装App Store模块、权限设置或管理员访问权限。

安全写入流程如何工作？

服务器需要多步审批流程：preview_write创建非执行有效载荷，validate_write根据实时元数据进行检查，execute_approved_write仅在所有安全检查通过（包括同一会话令牌验证）时执行。

mcp-odoo 对比