快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

命令预览

pip install -r requirements.txt

详细介绍

Odoo 19 MCP Server (JSON-2 API)

![odoo19-mcp-server MCP server](https://glama.ai/mcp/servers/twtrubiks/odoo19-mcp-server)

![License: Apache-2.0](LICENSE) ![Python](https://www.python.org/) ](https://github.com/twtrubiks/odoo19-mcp-server/stargazers) ](https://github.com/twtrubiks/odoo19-mcp-server/commits/main) ![Awesome MCP Servers](https://github.com/punkpeye/awesome-mcp-servers)

Youtube Tutorial - MCP Server 自己做！Odoo 19 + FastMCP 完整開發教學

Odoo 19 MCP Server，使用 JSON-2 API 連線。

本專案基於 Odoo 19 JSON-2 API 完整使用指南開發。

執行畫面

技術棧

Python: 3.13
FastMCP: >=3.0.0,|MCP Protocol

stdio/http/sse| Server R --> DI T --> DI DI --> RPC RPC -->|HTTP/HTTPS| Odoo


## MCP 核心概念

### Resources vs Tools

| 特性 | Resources | Tools |
|------|-----------|-------|
| **用途** | 提供上下文資訊 | 執行操作/動作 |
| **觸發** | 客戶端控制（如 Claude Code） | LLM 自動決定呼叫 |
| **參數** | 無（或 URI 參數） | 有（需 LLM 生成） |
| **類比** | 員工手冊（背景知識） | 工具箱（按需使用） |
| **HTTP 類比** | GET（讀取） | POST/PUT/DELETE（操作） |

**Resources** - 動態上下文，LLM 一開始就知道的背景資訊：

odoo://user → "我是誰" odoo://company → "我在哪間公司" odoo://models → "有哪些模型可用"


**Tools** - 需要時才呼叫的操作：

search_records(model="res.partner", domain=[...]) → 搜尋 create_record(model="sale.order", values={...}) → 建立


### 為什麼不用 Default Prompt？

| 方式 | Default Prompt | Resource |
|------|----------------|----------|
| 資料來源 | 寫死在程式碼 | 即時從 Odoo 查詢 |
| 更新時機 | 部署時 | 每次連線時 |
| 換用戶登入 | 資訊錯誤 | 自動正確 |

❌ Default Prompt（寫死）

SYSTEM_PROMPT = "當前用戶: Admin" # 換人登入就錯了

✅ Resource（動態）

@mcp.resource("odoo://user") def get_current_user(): return client.read("res.users", [uid]) # 即時查詢


**結論**：Resource 是「動態的上下文」，不是靜態文字。

> 參考：[MCP Resources](https://modelcontextprotocol.io/docs/concepts/resources) | [MCP Tools](https://modelcontextprotocol.io/docs/concepts/tools)

## 環境變數

| 變數 | 說明 | 預設值 |
|------|------|--------|
| `ODOO_URL` | Odoo 伺服器 URL | `http://localhost:8069` |
| `ODOO_DATABASE` | 資料庫名稱 | - |
| `ODOO_API_KEY` | API Key 認證 | - |
| `READONLY_MODE` | 唯讀模式（禁止寫入操作） | `false` |

建立 `.env` 檔案：

cp .env.example .env


## 安裝

pip install -r requirements.txt


## 啟動方式

### 開發模式（MCP Inspector）

fastmcp dev inspector odoo_mcp_server.py


## 傳輸模式（Transport）

本專案支援三種 MCP 傳輸模式：

| 模式 | 說明 | 適用情境 |
|------|------|----------|
| `stdio` | 標準輸入輸出（預設） | Claude Desktop、Cursor IDE、本機開發 |
| `http` | HTTP 協定 | 遠端服務、n8n、Web 應用整合 |
| `sse` | Server-Sent Events（已棄用） | 向下相容舊版 Client |

### stdio vs HTTP/SSE：算力位置

兩種模式的關鍵差異在於「誰來啟動 MCP Server」以及「算力在哪裡執行」：

**stdio 模式（本機算力）**

┌─────────────────────────────────────┐ │ 你的電腦 💻 │ │ │ │ Claude Desktop ──> MCP Server │ │ (使用本機算力) │ └─────────────────────────────────────┘


- Client（如 Claude Desktop）啟動 MCP Server 作為子進程
- MCP Server 使用你電腦的 CPU/RAM
- Server 隨 Client 啟動/關閉

**HTTP/SSE 模式（遠端算力）**

┌──────────────┐ ┌──────────────────┐ │ 你的電腦 │ │ 雲端 ☁️ │ │ │ │ │ │Claude Desktop│ ──網路──>│ MCP Server │ │ (輕量) │ │ (使用雲端算力) │ └──────────────┘ └──────────────────┘


- MCP Server 獨立運行在雲端/遠端主機
- 多個 Client 可同時連線同一個 Server
- 適合團隊共用、n8n 整合、正式環境

### 啟動不同模式

stdio 模式（預設）

python odoo_mcp_server.py

HTTP 模式

python odoo_mcp_server.py --transport http --host 0.0.0.0 --port 8000

SSE 模式（已棄用，建議使用 HTTP）

python odoo_mcp_server.py --transport sse --host 0.0.0.0 --port 8000


### 雲端部署（HTTP 模式）

Docker Compose 範例：

services: odoo-mcp: build: . ports: - "8000:8000" environment: - ODOO_URL=http://odoo:8069 - ODOO_DATABASE=odoo19 - ODOO_API_KEY=your_api_key_here command: ["python", "odoo_mcp_server.py", "--transport", "http", "--host", "0.0.0.0", "--port", "8000"] restart: unless-stopped


Client 設定(claude)改用 URL 連線：

claude mcp add --transport http odoo-mcp https://your-cloud-server.com:8000/mcp


手動設定 JSON（加到 `~/.claude.json`）

{ "mcpServers": { "odoo-mcp": { "type": "http", "url": "https://your-cloud-server.com:8000/mcp" } } }


## MCP Resources

| URI | 說明 |
|-----|------|
| `odoo://models` | 列出所有模型 |
| `odoo://model/{model_name}` | 取得模型欄位定義 |
| `odoo://record/{model_name}/{record_id}` | 取得單筆記錄 |
| `odoo://user` | 當前登入用戶資訊 |
| `odoo://company` | 當前用戶所屬公司資訊 |

## MCP Tools

| Tool | 說明 | 唯讀 |
|------|------|------|
| `list_models` | 列出/搜尋可用模型 | Yes |
| `get_fields` | 取得模型欄位定義 | Yes |
| `search_records` | 搜尋記錄 | Yes |
| `count_records` | 計數記錄 | Yes |
| `read_records` | 讀取指定 ID 記錄 | Yes |
| `create_record` | 建立記錄 | No |
| `update_record` | 更新記錄 | No |
| `delete_record` | 刪除記錄（需二次確認） | No |
| `execute_method` | 執行模型方法 | Depends |

## Claude Code MCP 設定

設定檔位於 `~/.claude.json`：

### 本機執行

claude mcp add odoo-mcp-server -- python odoo_mcp_server.py


手動設定 JSON

{ "mcpServers": { "odoo-mcp-server": { "command": "/bin/python", "args": [ "odoo_mcp_server.py" ] } } }


### Docker（host.docker.internal）

適用於 Odoo 執行在本機的情況：

claude mcp add odoo-mcp-server -- docker run -i --rm --add-host=host.docker.internal:host-gateway -e ODOO_URL=http://host.docker.internal:8069 -e ODOO_DATABASE=odoo19 -e ODOO_API_KEY=your_api_key_here odoo-mcp-server


手動設定 JSON

{ "mcpServers": { "odoo-mcp-server": { "command": "docker", "args": [ "run", "-i", "--rm", "--add-host=host.docker.internal:host-gateway", "-e", "ODOO_URL=http://host.docker.internal:8069", "-e", "ODOO_DATABASE=odoo19", "-e", "ODOO_API_KEY=your_api_key_here", "odoo-mcp-server" ] } } }


### Docker（host network）

使用主機網路模式：

claude mcp add odoo-mcp-server -- docker run -i --rm --network host -e ODOO_URL=http://localhost:8069 -e ODOO_DATABASE=odoo19 -e ODOO_API_KEY=your_api_key_here odoo-mcp-server


手動設定 JSON

{ "mcpServers": { "odoo-mcp-server": { "command": "docker", "args": [ "run", "-i", "--rm", "--network", "host", "-e", "ODOO_URL=http://localhost:8069", "-e", "ODOO_DATABASE=odoo19", "-e", "ODOO_API_KEY=your_api_key_here", "odoo-mcp-server" ] } } }


### Docker（遠端 Odoo）

claude mcp add odoo-mcp-server -- docker run -i --rm -e ODOO_URL=https://example.com/ -e ODOO_DATABASE=odoo19 -e ODOO_API_KEY=your_api_key_here odoo-mcp-server


手動設定 JSON

{ "mcpServers": { "odoo-mcp-server": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "ODOO_URL=https://example.com/", "-e", "ODOO_DATABASE=odoo19", "-e", "ODOO_API_KEY=your_api_key_here", "odoo-mcp-server" ] } } }


## Docker 建置

docker build -t odoo-mcp-server .


## Gemini MCP 設定

gemini mcp add --scope user odoo-mcp docker -- run -i --rm --add-host=host.docker.internal:host-gateway -e ODOO_URL=http://host.docker.internal:8069 -e ODOO_DATABASE=odoo19 -e ODOO_API_KEY=your_api_key_here odoo-mcp-server


手動設定 JSON（加到 `~/.gemini/settings.json`）

{ "mcpServers": { "odoo-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "--add-host=host.docker.internal:host-gateway", "-e", "ODOO_URL=http://host.docker.internal:8069", "-e", "ODOO_DATABASE=odoo19", "-e", "ODOO_API_KEY=your_api_key_here", "odoo-mcp-server" ] } } }


## 安全機制

### 唯讀模式

設定 `READONLY_MODE=true` 啟用唯讀模式，適用於生產環境查詢：

- 寫入工具（`create_record`、`update_record`、`delete_record`、`execute_method`）透過 FastMCP tags 直接隱藏，LLM 不會看到這些工具

### 刪除二次確認

`delete_record` 內建 confirm 機制，LLM 必須先以 `confirm=False` 呼叫取得確認提示，經使用者同意後才能以 `confirm=True` 執行刪除。

## 健康檢查

HTTP/SSE transport 模式下提供 `/health` 端點：

curl http://localhost:8000/health

{"status": "healthy", "service": "odoo-mcp-server", "version": "1.0.0"}


適用於 Docker healthcheck、Kubernetes probe、load balancer 探活。stdio 模式下不影響。

## License

Apache 2.0

目录标签

PythonClaudeAI代理Odoo集成本地部署JSON-2APIMCP协议动态资源工具操作

支持客户端

Claude DesktopClaudeCursor

接入字段

传输方式（transport，传输协议）

stdio

鉴权方式（authType，认证方式）

api-key

工具数量（toolCount，工具数）

9

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

stdioapi-key部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

来源信息

MCP World

mcpworld.com

/detail/37132811f3593a8a41a51e19170bcf75

一个基于Odoo 19和JSON-2 API的MCP服务器，提供动态资源和工具操作，支持多种传输模式。

OD

Glama

glama.ai

/mcp/servers/twtrubiks/odoo19-mcp-server

MCP Server for Odoo 19 using JSON-2 API, built with FastMCP

继续浏览同类 MCP

更多AI代理 MCP（18,706）返回 MCP 目录

上一个 MCP

Odoo 0a1fd36b

全面解析Odoo Sh MCP ServerMCP Server的核心功能、安装配置和实用案例。作为顶级Model Context Protocol服务器，Odoo Sh MCP Server能让AI助手访问实时数据、执行操作，为您提供更智能的工作体验和自动化解决方案。

下一个 MCP

Odoo Fast MCP

一个基于OdooRPC的模型上下文协议（MCP）服务器，为AI助手提供与Odoo ERP系统交互的标准化接口。

Odoo19 MCP Server