Odoo MCP Server Unofficial

🚀 Odoo MCP 服務器

Odoo MCP 服務器提供對 Odoo 18.0（JSON - RPC）和 Odoo 提取 API 的高級、安全訪問，可用於 OCR 文檔解析。

🚀 快速開始

命令行方式

1. 克隆倉庫

   git clone https://github.com/onlybets/odoo-mcp-server-unofficial.git
   cd odoo-mcp-server-unofficial
   

2. 配置憑證

   cp .env.example .env
   # 編輯 .env 並填寫您的 Odoo/提取憑證
   

3. 使用 Cline 運行（無需自行託管）
   • Cline 會自動在本地運行服務器。
   • 只需在 Cline 中打開倉庫並開始使用工具即可！

✨ 主要特性

提供對 Odoo 18.0（JSON - RPC）和 Odoo 提取 API 的高級、安全訪問，可用於 OCR 文檔解析。

📦 安裝指南

依賴項

• Python 3.8+
• Flask
• Redis（可選，用於緩存）

安裝命令

pip install flask redis

運行命令

python app.py

💻 使用示例

工具及 JSON 模式

1. list_models

返回當前用戶可見的模型。

• 輸入：無
• 輸出

[
  {"model": "res.partner", "name": "Contact"},
  {"model": "crm.lead", "name": "Lead"}
]

2. get_fields

返回模型的字段及元數據。

• 輸入

{ "model": "res.partner" }

• 輸出

{
  "id": {"string": "ID", "type": "integer", "required": true, "readonly": true},
  "name": {"string": "Name", "type": "char", "required": true, "readonly": false}
}

3. search_read

從模型中搜索並讀取記錄。

• 輸入

{
  "model": "res.partner",
  "domain": [["is_company", "=", true]],
  "fields": ["id", "name", "email"],
  "limit": 10
}

• 輸出

[
  {"id": 7, "name": "Acme Corp", "email": "info@acme.com"}
]

4. create_record

在模型中創建新記錄。

• 輸入

{
  "model": "res.partner",
  "values": {"name": "New Partner", "email": "new@partner.com"}
}

• 輸出

{ "id": 42 }

5. update_record

更新模型中的一條或多條記錄。

• 輸入

{
  "model": "res.partner",
  "ids": [42],
  "values": {"email": "updated@partner.com"}
}

• 輸出

{ "success": true }

6. delete_record

刪除模型中的一條或多條記錄。

• 輸入

{
  "model": "res.partner",
  "ids": [42]
}

• 輸出

{ "success": true }

7. extract_parse

啟動文檔提取任務。

• 輸入

{
  "document_base64": "<base64-encoded-pdf>",
  "doc_type": "invoice",
  "version": "18.0"
}

• 輸出

{ "status": "processing" }

8. extract_status

檢查提取任務的狀態。

• 輸入

{
  "task_id": "<id>"
}

• 輸出

{
  "task_id": "<id>",
  "status": "completed",
  "result": {"key": "value"}
}

🔧 技術細節

依賴項

• Python 3.8+
• Flask
• Redis（可選，用於緩存）

安裝

pip install flask redis

運行

python app.py

📄 許可證

MIT License

Odoo MCP 協議

https://modelcontextprotocol.org/