odoo-sh-readonly-mcp 🔒

MCP solo lectura para Odoo.sh: builds, entornos, logs y estado del sistema — consultable por una AI sin entrar a la web.

Sin tools de escritura: no hay git push, ni shell arbitrario, ni escritura de archivos. SSH via execFile (sin shell → sin command injection) con comandos whitelisted. El smoke test de CI falla el build si alguna vez aparece una tool con nombre de escritura o sin readOnlyHint.

📑 Tabla de contenidos

• Tools

• Instalación via imagen GHCR

• Instalación local (Node)

• Configuración

• Ejemplos de uso

• Nota técnica

• Seguridad

Related MCP server: sonarqube-api-mcp

🧰 Tools

🐳 Instalación via imagen GHCR (recomendado)

Cada push a main publica una imagen multi-arch (amd64/arm64) en GitHub Container Registry:

ghcr.io/ai-zar/odoo-sh-readonly-mcp:latest

1. Autenticarse contra GHCR

El repo es privado, así que la imagen también. Necesitás un PAT con scope read:packages:

echo $GITHUB_PAT | docker login ghcr.io -u TU_USUARIO --password-stdin
docker pull ghcr.io/ai-zar/odoo-sh-readonly-mcp:latest

2. Configurar el cliente MCP

Solo builds/entornos (sin SSH):

{
  "mcpServers": {
    "odoo-sh": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "ODOO_SH_SESSION_ID",
        "-e", "ODOO_SH_PROJECT",
        "ghcr.io/ai-zar/odoo-sh-readonly-mcp:latest"
      ],
      "env": {
        "ODOO_SH_SESSION_ID": "tu_session_id",
        "ODOO_SH_PROJECT": "mi-proyecto"
      }
    }
  }
}

Con SSH (logs / system / DBs) — montá la clave privada read-only:

{
  "mcpServers": {
    "odoo-sh": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "/home/usuario/.ssh/odoo_sh:/keys/id:ro",
        "-e", "ODOO_SH_SESSION_ID",
        "-e", "ODOO_SH_SSH_HOST",
        "-e", "ODOO_SH_SSH_USER",
        "-e", "ODOO_SH_SSH_KEY_PATH",
        "ghcr.io/ai-zar/odoo-sh-readonly-mcp:latest"
      ],
      "env": {
        "ODOO_SH_SESSION_ID": "tu_session_id",
        "ODOO_SH_SSH_HOST": "mi-proyecto.dev.odoo.com",
        "ODOO_SH_SSH_USER": "BUILD_ID",
        "ODOO_SH_SSH_KEY_PATH": "/keys/id"
      }
    }
  }
}

⚠️ En Windows usá rutas estilo C:\\Users\\usuario\\.ssh\\odoo_sh:/keys/id:ro en el -v. ODOO_SH_SSH_KEY_PATH siempre apunta a la ruta dentro del contenedor (/keys/id).

3. Probar la imagen a mano

docker run -i --rm -e ODOO_SH_SESSION_ID=xxx \
  ghcr.io/ai-zar/odoo-sh-readonly-mcp:latest

Pegá esto en stdin para ver las tools:

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"cli","version":"1"}}}
{"jsonrpc":"2.0","id":2,"method":"tools/list"}

💻 Instalación local (Node)

git clone https://github.com/ai-zar/odoo-sh-readonly-mcp.git
cd odoo-sh-readonly-mcp
npm install
npm run smoke      # verifica que arranca y expone las 8 tools

{
  "mcpServers": {
    "odoo-sh": {
      "command": "node",
      "args": ["C:\\ruta\\absoluta\\odoo-sh-readonly-mcp\\index.js"],
      "env": { "ODOO_SH_SESSION_ID": "tu_session_id" }
    }
  }
}

⚙️ Configuración

🍪 Obtener la cookie de sesión

Odoo.sh no expone API pública; su panel web es un Odoo estándar. Se usa tu propia sesión:

1. Logueate en https://www.odoo.sh

2. F12 → Application → Cookies → www.odoo.sh → copiá session_id

La cookie expira: cuando las llamadas fallen con error de sesión, repetí el paso. Los permisos son exactamente los de tu usuario — ni más ni menos.

💬 Ejemplos de uso con AI

• "¿Cómo están los builds de staging?"

• "¿Falló algún build esta semana en main?"

• "Mostrame los últimos errores del log de producción"

• "¿Cuánto pesa la DB de producción?"

• "Listame todos los entornos y en qué commit está cada uno"

🔬 Nota técnica: modelos paas.*

Los modelos internos de Odoo.sh (paas.build, paas.branch, ...) no están documentados y sus campos pueden cambiar. Por eso:

• resilientSearchRead: si un campo no existe, reintenta pidiendo todos los campos legibles

• odoo_sh_model_fields: la AI puede autodescubrir el schema y después consultar con precisión via odoo_sh_search_read

Primera vez, pedile a la AI:

"Usá odoo_sh_model_fields sobre paas.build y después listá los builds con los campos correctos"

🛡️ Seguridad

MIT — ver LICENSE.