Odoo 19 MCP Server

Odoo 19 開發用 MCP (Model Context Protocol) Server，提供資料庫查詢、模組管理、服務控制等功能。

功能

資料庫查詢

• odoo_sql_query - 執行 SQL 查詢（唯讀）
• odoo_model_search - ORM 風格查詢
• odoo_model_count - 記錄計數
• odoo_list_databases - 列出資料庫

模組管理

• odoo_module_info - 查詢模組資訊
• odoo_module_list - 列出模組
• odoo_module_update - 更新模組
• odoo_module_install - 安裝模組
• odoo_module_dependencies - 查詢依賴
• odoo_module_scaffold - 建立新模組骨架 ✨ 新功能

Odoo Shell

• odoo_shell_exec - 執行 Python 程式碼

服務管理

• odoo_service_status - 服務狀態
• odoo_service_restart - 重啟服務
• odoo_service_logs - 查看日誌

開發輔助

• odoo_test_run - 執行測試
• odoo_i18n_export - 匯出翻譯

安裝

cd /opt/odoo19/odoo-mcp-server
npm install
npm run build

使用方式

直接執行

npm start
# 或開發模式
npm run dev

配置到 Gemini Code Assist (Antigravity)

編輯 ~/.gemini/antigravity/mcp_config.json：

{
  "mcpServers": {
    "odoo": {
      "command": "node",
      "args": ["/opt/odoo19/odoo-mcp-server/dist/index.js"]
    }
  }
}

配置到 Claude Desktop

編輯 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "odoo": {
      "command": "node",
      "args": ["/opt/odoo19/odoo-mcp-server/dist/index.js"]
    }
  }
}

配置到 Cursor

在 Settings → MCP Servers 中添加：

• Command: node
• Args: /opt/odoo19/odoo-mcp-server/dist/index.js

環境變數

可透過環境變數覆寫預設配置：

| 變數 | 預設值 | 說明 | |------|--------|------| | ODOO_DB_HOST | 127.0.0.1 | 資料庫主機 | | ODOO_DB_PORT | 5432 | 資料庫埠號 | | ODOO_DB_USER | odoo17 | 資料庫使用者 | | ODOO_DB_PASSWORD | odoo17 | 資料庫密碼 | | ODOO_DB_NAME | odoo19db | 資料庫名稱 | | ODOO_PATH | /opt/odoo19 | Odoo 路徑 | | ODOO_VENV | /opt/odoo19-venv | Python venv 路徑 | | ODOO_CONFIG | /etc/odoo19.conf | 配置檔路徑 | | ODOO_LOG | /var/log/odoo/odoo19.log | 日誌檔路徑 | | ODOO_SERVICE | odoo19.service | 服務名稱 | | ODOO_ADDONS_PATH | /opt/odoo19/addons,/opt/odoo19/odoo19-local-addons | Addons 路徑（逗號分隔） |

與 Odoo 17 版的差異

• 所有路徑預設值更新為 Odoo 19
• 新增 odoo_module_scaffold 工具
• 改善多資料庫連線池管理
• 放寬 Shell 安全檢查（允許合法的 exec/eval 用途）
• 新增 ODOO_ADDONS_PATH 環境變數支援

安全控制

• SQL 查詢僅允許 SELECT 和 WITH
• 禁止 DROP, DELETE, TRUNCATE 等危險操作
• Shell 命令禁止 os.system, subprocess 等危險操作
• 所有操作記錄到日誌

日誌

日誌存放於 ~/.odoo-mcp/logs/：

• combined.log - 所有日誌
• error.log - 錯誤日誌