# mcp-server-odoo (KLC fork)

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

本 repo 是 [`ivnvxd/mcp-server-odoo`](https://github.com/ivnvxd/mcp-server-odoo) 的
fork，額外加入 **`sql_query` 工具**等客製。授權沿用上游的 **MPL-2.0**。

---

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

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

```bash
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`：

```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`](https://docs.astral.sh/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](LICENSE)。
- 原始專案：[`ivnvxd/mcp-server-odoo`](https://github.com/ivnvxd/mcp-server-odoo)，
  著作權歸原作者所有；本 fork 依 MPL-2.0 條款釋出修改版本。