Panda Odoo Mcp Server

mcp-odoo-panda

适用于 Odoo 的 MCP 服务 — 让 Claude、Cursor 或任何 MCP 客户端搜索、读取、创建、更新 Odoo ERP 记录并调用方法。

面向希望在大模型客户端中使用 Odoo 工具、又不想编写自定义连接器的开发者和集成商。

快速入门

要求： Python 3.10+，以及一个可访问的 Odoo 15+ 实例（本地或远程）。

1. 安装

   git clone https://github.com/pandeussilvae/mcp-odoo-panda.git
   cd mcp-odoo-panda
   pip install .
   

2. 根据示例进行配置

   cp odoo_mcp/config/config.example.yaml odoo_mcp/config/config.yaml
   # edit config.yaml — set odoo_url, database, username, api_key
   

3. 选择客户端连接方式（仅支持 MCP 协议版本 2026-07-28）

   模式	适用场景
   stdio（默认）	同一台机器上的 Claude Desktop / Cursor（官方 mcp SDK）
   mcp_2026_07_28	远程 Streamable HTTP（通过 mcp_sdk_server 使用 POST /mcp）

   在 config.yaml 中设置 connection_type（参见 stdio 与 Streamable HTTP）。

4. 运行

   odoo-mcp-server --config odoo_mcp/config/config.yaml
   # or: python -m odoo_mcp.core.mcp_server --config odoo_mcp/config/config.yaml
   

5. 连接 MCP 客户端（Claude Desktop / Cursor）— 参见连接 Claude 或 Cursor。

Docker 替代方案：docker compose up -d（实验环境栈；仅供开发使用的默认值）。

最简配置

复制粘贴即可开始（odoo_mcp/config/config.yaml）：

odoo_url: http://localhost:8069
database: your_database
username: your_username
api_key: your_password_or_api_key

protocol: xmlrpc
connection_type: stdio
transport_type: stdio

设置环境变量后，其值会覆盖配置文件中的对应项：ODOO_URL、ODOO_DB、ODOO_USER、ODOO_PASSWORD。

stdio 与 Streamable HTTP

两种传输方式都通过官方 Python mcp SDK（≥2.1.1）使用 MCP protocolVersion: 2026-07-28。

• stdio — MCP 客户端启动此进程，并通过 stdin/stdout 与之通信（仅限 SDK 新版）。最适合桌面应用（Claude、Cursor）。无需开放端口。
• mcp_2026_07_28（别名 http）— 在 POST /mcp 上使用 Streamable HTTP（mcp_sdk_server + uvicorn）。适用于远程 / Docker 场景。

迁移说明

SSE / 2026-07-28 之前的 HTTP 已移除。 connection_type: sse、streamable_http 和 modern_http 会在启动时失败。请将客户端升级为使用 2026-07-28 封装格式（server/discover，每个请求的 _meta）。

HTTP 示例（开发环境）：

connection_type: mcp_2026_07_28
http:
  host: 127.0.0.1   # prefer loopback; 0.0.0.0 is DEV-ONLY
  port: 8080

连接 Claude 或 Cursor

Cursor — 添加 MCP 服务条目（Settings → MCP），例如：

{
  "mcpServers": {
    "odoo": {
      "command": "odoo-mcp-server",
      "args": ["--config", "/absolute/path/to/mcp-odoo-panda/odoo_mcp/config/config.yaml"]
    }
  }
}

Claude Desktop — 在其 MCP 配置文件（claude_desktop_config.json）中使用相同格式：command + args 指向你的安装位置和配置文件。

请使用绝对路径。不要提交包含真实密码的客户端配置。

你将获得

• 搜索 / 读取 / 创建 / 写入 / 解除链接 Odoo 记录
• 调用自定义模型方法
• 会话处理、速率限制、可选的 HTTP CORS
• 通过官方 SDK 使用 MCP Streamable HTTP（CONNECTION_TYPE=mcp_2026_07_28；协议 2026-07-28）

安全

• 绝不要提交真实密码或 API 密钥。 将 config.yaml 保留在本地（该文件已被 gitignore）；仅跟踪 config.example.yaml。
• Compose / Dockerfile 中的 admin 默认密码仅供开发环境使用，适用于本地实验环境。
• 绑定到 0.0.0.0 和设置 CORS allowed_origins: ["*"] 仅供开发环境使用。生产环境请使用环回地址或私有接口，并明确指定来源。
• 凭据优先使用环境变量或密钥管理器。

独立项目

本项目是一个独立的 MIT MCP 服务，仅连接单个 Odoo 实例。它不是多租户 SaaS 网关。请参阅 ODWARD_BOUNDARY.md。

可选：该项目被 Odward Connect 用作上游引擎；此集成位于本仓库之外。

Deeper docs

Doc	Topic
CONFIGURATION.md	Full configuration reference
docs/API_REFERENCE.md	Tools / API
docs/DEVELOPER_GUIDE.md	Architecture for contributors
docs/DOCKER_DEPLOYMENT.md	Docker notes
docs/server_usage.md	Server usage
LEGGIMI.md	Italian quickstart

Historical refactor notes (when present) live under docs/archive/.

License

MIT — see LICENSE.

---

Developed by Paolo Nugnes and TechLab · [email protected] · [email protected]