Odoo

mcp-odoo

Odoo MCP 工具包 — 通过 Odoo 的外部 JSON-RPC API 使用 ERP/CRM。

属于 Pipeworx — 一个将 AI Agent 连接到 1683+ 个实时数据源的 MCP 网关。

工具

工具	描述
odoo_search_partners	按名称、电子邮件或公司标记搜索 Odoo 联系人和公司（res.partner）。返回 id、名称、电子邮件、电话以及公司/客户标记。适用于“查找名为 X 的联系人/客户”或“列出公司”。
odoo_list_sale_orders	列出 Odoo 销售订单/报价单（sale.order）。返回名称、客户（partner_id）、amount_total、状态（draft/sent/sale/done/cancel）和 date_order。可按状态筛选。适用于“最近的销售订单”或“未结报价单”。
odoo_list_crm_leads	列出 Odoo CRM 线索和商机（crm.lead）。返回名称、联系人、email_from、expected_revenue、probability、stage_id 和类型（线索/商机）。适用于“未结商机”或“销售管道”。
odoo_list_invoices	列出 Odoo 客户发票（account.move，其中 move_type=out_invoice）。返回名称、partner_id、amount_total、amount_residual、状态（draft/posted/cancel）、payment_state 和 invoice_date。适用于“未付款发票”或“最近的客户发票”。
odoo_query_model	面向高级用户的通用查询：对任意 Odoo 模型运行 search_read。提供 model（例如 "product.template"）、domain（Odoo 三元组列表，例如 [["list_price",">",100]]）、fields 和 limit。适用于上述工具均不符合需求的情况。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "odoo": {
      "url": "https://gateway.pipeworx.io/odoo/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/odoo/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 共享元工具 — ask_pipeworx、 discover_tools、search_within、remember/recall，以及网关全局工具集中的其他工具。因此，你看到的工具数量会多于此表：目前，单个工具包端点除了列出该工具包自身的工具外，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是当天实际情况的权威依据。

这是有意为之，并非意外的多路复用。元工具可让范围受限的连接通过 ask_pipeworx 跨整个目录进行路由，从而回答此工具包未涵盖的问题，而无需添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义占用的上下文超过路由功能带来的价值，请连接一次完整网关，而不是连接多个工具包端点。

也可以连接完整的 Pipeworx 网关，直接列出所有工具包的工具，而不只是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1683+ 个数据源。唯一的区别是直接列出哪个工具包的工具；从任意一个端点都可以通过 ask_pipeworx 使用所有工具。

没有 MCP 客户端？通过 HTTP 调用

此工具包需要你自己的 API 密钥（_apiKey）——我们不会为它代理 API 密钥，因此这里没有无需密钥即可运行的 curl 命令。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/odoo_search_partners。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账号）

此软件包也可以作为本地 stdio MCP 服务运行——无需 Pipeworx 账号，也无需经由网关往返：

{
  "mcpServers": {
    "odoo": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-odoo"]
    }
  }
}

也可以直接运行，以确认它能正常启动：

npx -y @pipeworx/mcp-odoo

它通过 stdin/stdout 进行 MCP 通信，并仅对该工具包自身的工具响应 initialize/tools/list/tools/call——不包含上方网关连接额外提供的任何共享元工具。相同的源代码，相同的工具，但没有 ask_pipeworx 路由。

与 ask_pipeworx 搭配使用

你可以用通俗英语提问，而不是直接调用工具——这既适用于上方的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Odoo data" })

网关会自动选择合适的工具并填写参数。

更多

• 文档和指南
• pipeworx.io

License

MIT