mcp-server-odoo (KLC fork)

一個把 Odoo ERP 接進 Claude 等 MCP 用戶端的 MCP server。

本 repo 是 ivnvxd/mcp-server-odoo 的 fork，額外加入 sql_query 工具等客製。授權沿用上游的 MPL-2.0。

---

安裝與連線（Claude Code，一行）

不需要 clone、不需要開終端機——在 Claude Code 直接執行：

claude mcp add -s user \
  -e ODOO_URL=https://你的網址.odoo.com \
  -e ODOO_DB=你的資料庫名 \
  -e ODOO_API_KEY=你的金鑰 \
  odoo -- uvx --from git+https://github.com/futurecorptw/mcp-server-odoo mcp-server-odoo

uvx 會直接從本 repo 抓原始碼、建好環境並執行，不必先發佈到 PyPI。

想鎖定版本可在網址後面加 @ 加 tag 或 commit，例如 git+https://github.com/futurecorptw/mcp-server-odoo@v0.3.1。

Claude Desktop

把對應設定放進 claude_desktop_config.json：

{
  "mcpServers": {
    "odoo": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/futurecorptw/mcp-server-odoo", "mcp-server-odoo"],
      "env": {
        "ODOO_URL": "https://你的網址.odoo.com",
        "ODOO_DB": "你的資料庫名",
        "ODOO_API_KEY": "你的金鑰"
      }
    }
  }
}

---

環境變數

變數	說明
ODOO_URL	Odoo 網址，例：https://your-company.odoo.com
ODOO_DB	資料庫名稱
ODOO_API_KEY	你個人的 Odoo API 金鑰（依你自己的權限運作，勿共用）

需要 Odoo 端已安裝「Odoo MCP Server」模組並開放要存取的 model。

---

前提

• 已安裝 uv（提供 uvx）：
  • macOS / Linux：curl -LsSf https://astral.sh/uv/install.sh | sh
  • Windows：irm https://astral.sh/uv/install.ps1 | iex
• Python 3.10+

---

授權與致謝

• 授權：Mozilla Public License 2.0（MPL-2.0），見 LICENSE。
• 原始專案：ivnvxd/mcp-server-odoo， 著作權歸原作者所有；本 fork 依 MPL-2.0 條款釋出修改版本。