MCPOdoo — Odoo Read-Only MCP (Docker)

MCP server untuk cek data Odoo production/staging via JSON-RPC (read-only).
Proyek standalone di luar repo addon. Satu instance MCP bisa melayani beberapa server Odoo (beda URL/DB/versi) lewat profile.

Persiapan

Clone repo, lalu pilih salah satu mode di bawah. File profiles.json dan .env bersifat lokal (ada di .gitignore) — jangan di-commit.

Opsi A — banyak server (disarankan)

cp profiles.example.json profiles.json
# edit url / db / user per profile (tanpa password)

./scripts/keychain-store.sh prod password
./scripts/keychain-store.sh staging password
docker compose build

Opsional di .env: MCPO_ODOO_DEFAULT_PROFILE=staging dan limit RPC.

Opsi B — satu server (legacy)

cp .env.example .env
# ODOO_URL, ODOO_DB, ODOO_USER — password di Keychain: ./scripts/keychain-store.sh default password
docker compose build

Uji image (opsional)

MCP memakai stdio — biasanya lewat Cursor:

docker compose run --rm -T mcp
# menunggu input JSON-RPC dari stdin; Ctrl+C untuk keluar

Related MCP server: mcp-mysql-server

Cursor IDE

Tambahkan di Settings → MCP (atau merge ke ~/.cursor/mcp.json):

{
  "mcpServers": {
    "odoo-readonly": {
      "command": "/ABSOLUTE/PATH/TO/MCPOdoo/scripts/run-mcp.sh"
    }
  }
}

Ganti path dengan lokasi clone Anda. Contoh lengkap: cursor-mcp.example.json.

Script run-mcp.sh menjalankan:

docker compose run --rm -T mcp
(-T = tanpa TTY, cocok untuk protokol MCP stdio.)

Penting: Build image dulu (docker compose build). Setiap ubah kode Python, build ulang.

MCP tidak aktif / error di Cursor

Di Settings → MCP, server odoo-readonly harus hijau. Jika Error / tool discovery gagal:

Tes manual (harus tetap jalan, tidak exit 127):

/path/to/MCPOdoo/scripts/run-mcp.sh
# menunggu stdio; Ctrl+C
env -i HOME="$HOME" PATH="/usr/bin:/bin" /path/to/MCPOdoo/scripts/run-mcp.sh
# setelah fix PATH di script: tidak boleh "docker not found"

Nama server di Cursor: odoo-readonly (bukan “MCPOdoo”). Tool muncul sebagai namespace user-odoo-readonly.

Akses Odoo dari container

• Production HTTPS publik: cukup set ODOO_URL=https://... di .env.

• Odoo di host lokal (macOS): gunakan ODOO_URL=http://host.docker.internal:8069 (compose sudah menambah extra_hosts).

Keamanan

• Whitelist method ORM di MCP; denylist model sensitif (ir.config_parameter, dll.).

• Buat user Odoo khusus read-only + API key; jangan pakai admin.

• Jangan commit .env, profiles.json, atau password/API key. Detail: SECURITY.md.

Menyimpan password di MacBook (lebih aman dari plain .env)

Keychain (per profile):

./scripts/keychain-store.sh prod password
./scripts/keychain-store.sh staging password
# legacy single-server: ./scripts/keychain-store.sh default password

Account Keychain: prod.ODOO_PASSWORD, staging.ODOO_PASSWORD, atau ODOO_PASSWORD untuk profile default. Service: MCPOdoo.

Beberapa server Odoo (1 MCP)

Contoh prompt Cursor:

• “Panggil odoo_list_profiles, lalu odoo_session_info untuk prod dan staging.”

• “odoo_search_read profile prod, model hr.attendance, domain …”

1Password (opsional, tanpa simpan di .env):

op item get "<your-item>" --fields password --reveal
# atau op run -- docker compose run ...

Cursor MCP cukup memanggil run-mcp.sh; rahasia tidak perlu ada di mcp.json.

Tool MCP

Tanpa Docker (dev)

python3.12 -m venv .venv && source .venv/bin/activate
pip install -e .
export $(grep -v '^#' .env | xargs)
odoo-readonly-mcp

Struktur

MCPOdoo/
  Dockerfile
  docker-compose.yml
  odoo_readonly_mcp/       # server MCP
  scripts/run-mcp.sh       # entry untuk Cursor
  profiles.example.json    # template multi-server (salin → profiles.json)
  .env.example
  cursor-mcp.example.json
  SECURITY.md
  LICENSE

Lisensi

MIT — lihat LICENSE.