odoo-mcp-multi 0.1.0

MCP Server for connecting Claude/Cursor to multiple Odoo instances

odoo-mcp-multi

MCP Server para conectar clientes MCP (Antigravity, Claude Desktop, Cursor, VS Code) a múltiples instancias de Odoo.

Características

• Gestión multi-perfil: Almacena credenciales de múltiples entornos (prod, staging, dev)
• Almacenamiento seguro: Credenciales en ~/.config/odoo-mcp/ con permisos 600
• Multi-protocolo: JSON-RPC (8.0+), JSON2 (19.0+), XML-RPC (legacy) con detección automática
• 7 herramientas MCP: search_read, write, create, execute_kw, list_models, list_fields, get_version
• CLI completo: Gestión de perfiles y servidor MCP

Instalación

# Usando pip
pip install .

# Usando uv
uv pip install .

# Modo desarrollo
pip install -e .

Después de instalar, el comando odoo-mcp estará disponible en tu PATH.

---

Inicio Rápido

# 1. Agregar un perfil
odoo-mcp add-profile

# 2. Verificar conexión
odoo-mcp test -p prod

# 3. Iniciar servidor MCP
odoo-mcp run -p prod

---

Comandos CLI

odoo-mcp add-profile

Wizard interactivo para agregar credenciales de una instancia Odoo.

odoo-mcp add-profile

Opciones:

Opción	Descripción
--name TEXT	Identificador del perfil (ej: prod, staging)
--url TEXT	URL de la instancia (ej: https://odoo.example.com)
--database TEXT	Nombre de la base de datos
--user TEXT	Usuario de Odoo
--password TEXT	Contraseña (se oculta al escribir)
--default	Establecer como perfil por defecto
--test / --no-test	Probar conexión antes de guardar (default: --test)

Ejemplo no interactivo:

odoo-mcp add-profile \
  --name prod \
  --url https://erp.miempresa.com \
  --database produccion \
  --user admin \
  --password secreto \
  --default

---

odoo-mcp list-profiles

Muestra todos los perfiles configurados.

odoo-mcp list-profiles

Opciones:

Opción	Descripción
--json	Salida en formato JSON

Ejemplo de salida:

Configured Profiles:
------------------------------------------------------------
  prod (default)
    URL:      https://erp.miempresa.com
    Database: produccion
    User:     admin

  staging
    URL:      https://staging.miempresa.com
    Database: staging_db
    User:     admin

---

odoo-mcp edit-profile

Modifica un perfil existente. Solo los campos especificados serán actualizados.

odoo-mcp edit-profile NOMBRE [OPCIONES]

Argumentos:

Argumento	Descripción
NAME	Nombre del perfil a editar (requerido)

Opciones:

Opción	Descripción
--url TEXT	Nueva URL
--database TEXT	Nuevo nombre de base de datos
--user TEXT	Nuevo usuario
--password	Solicita nueva contraseña interactivamente
--test	Probar conexión después de editar

Ejemplos:

# Cambiar solo la URL
odoo-mcp edit-profile prod --url https://nueva-url.com

# Cambiar usuario y contraseña
odoo-mcp edit-profile staging --user nuevo_admin --password

# Cambiar base de datos con prueba de conexión
odoo-mcp edit-profile dev --database nueva_db --test

---

odoo-mcp remove-profile

Elimina un perfil por nombre.

odoo-mcp remove-profile NOMBRE

Opciones:

Opción	Descripción
-f, --force	Omitir confirmación

Ejemplo:

odoo-mcp remove-profile staging -f

---

odoo-mcp set-default

Establece el perfil por defecto.

odoo-mcp set-default NOMBRE

Ejemplo:

odoo-mcp set-default prod

---

odoo-mcp test

Prueba la conexión a una instancia Odoo.

odoo-mcp test [-p PERFIL]

Opciones:

Opción	Descripción
-p, --profile TEXT	Perfil a usar (default: perfil por defecto)

Ejemplo:

odoo-mcp test -p prod
# ✓ Connection successful! Authenticated as UID 2
#   Server version: 16.0
#   Protocol: auto

---

odoo-mcp run

Inicia el servidor MCP.

odoo-mcp run [-p PERFIL]

Opciones:

Opción	Descripción
-p, --profile TEXT	Perfil a usar (default: perfil por defecto)

Ejemplo:

odoo-mcp run -p prod
# Starting MCP server with profile 'prod'...
#   URL: https://erp.miempresa.com
#   Database: produccion
#   User: admin

---

Configuración de Clientes MCP

Configuración Multi-Perfil

Hay dos enfoques para trabajar con múltiples instancias Odoo:

Opción 1: Múltiples servidores MCP (recomendado para uso frecuente)

Declara un servidor MCP por cada perfil. El cliente verá cada instancia como un servidor separado:

{
  "mcpServers": {
    "odoo-vauxoo": {
      "command": "odoo-mcp",
      "args": ["run", "-p", "vauxoo"]
    },
    "odoo-ingelub": {
      "command": "odoo-mcp",
      "args": ["run", "-p", "ingelub"]
    },
    "odoo-staging": {
      "command": "odoo-mcp",
      "args": ["run", "-p", "staging"]
    }
  }
}

Luego puedes decirle al AI: "En odoo-vauxoo, busca los proyectos de IA".

Opción 2: Servidor único con perfil default

Si usualmente trabajas con una sola instancia:

{
  "mcpServers": {
    "odoo": {
      "command": "odoo-mcp",
      "args": ["run"]
    }
  }
}

Sin -p, usa el perfil marcado como default. Cambia el default con:

odoo-mcp set-default vauxoo

---

Antigravity

Edita ~/.gemini/antigravity/mcp_config.json:

{
  "mcpServers": {
    "odoo-vauxoo": {
      "command": "odoo-mcp",
      "args": ["run", "-p", "vauxoo"]
    },
    "odoo-ingelub": {
      "command": "odoo-mcp",
      "args": ["run", "-p", "ingelub"]
    }
  }
}

Nota: Reinicia Antigravity después de modificar la configuración.

Claude Desktop

Edita ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "odoo": {
      "command": "odoo-mcp",
      "args": ["run", "-p", "prod"]
    }
  }
}

Cursor

Edita .cursor/mcp.json en tu proyecto o globalmente:

{
  "mcpServers": {
    "odoo": {
      "command": "odoo-mcp",
      "args": ["run", "-p", "prod"]
    }
  }
}

VS Code (con extensión MCP)

Edita .vscode/mcp.json o la configuración global:

{
  "mcpServers": {
    "odoo": {
      "command": "odoo-mcp",
      "args": ["run", "-p", "prod"]
    }
  }
}

---

Herramientas MCP Disponibles

Una vez el servidor está corriendo, estas herramientas están disponibles para Claude/Cursor:

search_read

Busca y lee registros de un modelo.

Parámetro	Tipo	Descripción
model	string	Nombre del modelo (ej: res.partner)
domain	string	Dominio de búsqueda (ej: [('name', 'ilike', 'John')])
fields	string	Campos separados por coma (ej: name,email,phone)
limit	int	Máximo de registros (default: 100)
offset	int	Registros a saltar (default: 0)
order	string	Ordenamiento (ej: name asc, id desc)

---

write

Actualiza registros existentes.

Parámetro	Tipo	Descripción
model	string	Nombre del modelo
ids	string	IDs como JSON o separados por coma (ej: [1,2,3] o 1,2,3)
values	string	Valores como JSON (ej: {"name": "Nuevo Nombre"})

---

create

Crea un nuevo registro.

Parámetro	Tipo	Descripción
model	string	Nombre del modelo
values	string	Valores como JSON (ej: {"name": "Alice", "email": "[e-mail]"})

---

execute_kw

Ejecuta cualquier método de un modelo Odoo.

Parámetro	Tipo	Descripción
model	string	Nombre del modelo
method	string	Nombre del método (ej: action_confirm, send)
args	string	Argumentos posicionales como JSON (ej: [[42]])
kwargs	string	Argumentos keyword como JSON (ej: {"force_send": true})

---

list_models

Lista los modelos disponibles en la instancia.

Parámetro	Tipo	Descripción
search	string	Filtro opcional por nombre del modelo

---

list_fields

Lista los campos de un modelo.

Parámetro	Tipo	Descripción
model	string	Nombre del modelo

---

get_version

Obtiene información de versión del servidor Odoo.

Sin parámetros.

---

Ejemplos de Uso en Claude

"Lista todos los contactos que contengan 'Juan' en el nombre"

search_read(model="res.partner", domain="[('name', 'ilike', 'Juan')]", fields="name,email,phone")

"Crea un nuevo contacto llamado Alice con email [e-mail]"

create(model="res.partner", values='{"name": "Alice", "email": "[e-mail]"}')

"Confirma el pedido de venta con ID 42"

execute_kw(model="sale.order", method="action_confirm", args="[[42]]")

"¿Qué campos tiene el modelo de facturas?"

list_fields(model="account.move")

---

Seguridad

• Las credenciales se almacenan en ~/.config/odoo-mcp/profiles.json
• Los permisos del archivo se configuran como 600 (solo lectura/escritura del propietario)
• Las contraseñas se manejan con SecretStr para evitar logging accidental

---

Desarrollo

# Instalar con dependencias de desarrollo
pip install -e ".[dev]"

# Ejecutar linting
ruff check odoo_mcp_multi/

# Formatear código
ruff format odoo_mcp_multi/

---

Licencia

MIT