Odoo 17 MCP Server

Odoo 17 開發用 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 Shell

• odoo_shell_exec - 執行 Python 程式碼

服務管理

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

開發輔助

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

安裝

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

使用方式

直接執行

npm start
# 或開發模式
npm run dev

配置到 Claude Desktop

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

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

配置到 Cursor

在 Settings → MCP Servers 中添加：

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

環境變數

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

| 變數 | 預設值 | 說明 | |------|--------|------| | ODOO_DB_HOST | localhost | 資料庫主機 | | ODOO_DB_PORT | 5432 | 資料庫埠號 | | ODOO_DB_USER | odoo17 | 資料庫使用者 | | ODOO_DB_PASSWORD | odoo17 | 資料庫密碼 | | ODOO_DB_NAME | odoo17db | 資料庫名稱 | | ODOO_PATH | /opt/odoo17/odoo17 | Odoo 路徑 | | ODOO_VENV | /opt/odoo17/odoo17-venv | Python venv 路徑 | | ODOO_CONFIG | /etc/odoo17.conf | 配置檔路徑 | | ODOO_SERVICE | odoo17.service | 服務名稱 |

安全控制

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

日誌

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

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