Odoo Migration Copilot

Convierte registros de actualización de Odoo y escaneos de addons en una lista de trabajo clasificada a través del servidor odoo-mcp

Por tuanle96 · tuanle96/mcp-odoo

Funciona con configuración ★ 8.0/10

Odoo Migration Copilot — Convierte registros de actualización de Odoo y escaneos de addons en una lista de trabajo clasificada a través del servidor odoo-mcp

Qué hace

Un playbook de tres fases para actualizaciones de versión de Odoo (16 a 17 a 18 a 19/20) que utiliza las herramientas de migración del servidor odoo-mcp: scan_addons_source y upgrade_risk_report para inventario, analyze_upgrade_log para clasificar fallos de staging como no_action / needs_review / needs_script, lookup_model_history para resolver renombres de modelos, y generate_json2_payload para la transición de XML-RPC a JSON-2. La salida es un encabezado de fase, una tabla de lista de trabajo de acción/categoría/evidencia/solución/estado, y una decisión de go/no-go con el recuento de needs_script abiertos. Se activa cuando se menciona la actualización o migración de versiones de Odoo, un registro de actualización fallido, errores de vista "attrs" de Odoo 17, o la deprecación de XML-RPC.

Informe de la prueba

Se clonó el repositorio y se instaló skills/odoo-migration-copilot en un HOME temporal (export HOME=$(mktemp -d)) — SKILL.md se ubicó en la ruta correcta, el frontmatter se analizó exactamente como nombre+descripción, no se referenciaron scripts, no se encontró curl|sh / base64 / secret-exfil / texto de inyección en ninguna parte bajo skills/, y las recuperaciones directas de SKILL.md, la habilidad hermana odoo-data-quality-gate, diagnostics.py y data/odoo_renames.json, todas devolvieron HTTP 200. El servidor MCP necesita credenciales de Odoo en vivo, pero cuatro de las cinco herramientas que el playbook invoca son funciones puramente impulsadas por la entrada, así que ejecuté analyze_upgrade_log_report, scan_addons_source_report, upgrade_risk_report, lookup_model_history_report y generate_json2_payload_report directamente contra un registro de fallo sintético de Odoo 16 a 17 de 14 líneas y un árbol de addons sintético acme_sales; solo get_odoo_profile y data_quality_report no pudieron ejecutarse. El artefacto de la habilidad obtuvo una estructura real sobre mi línea base sin ayuda — la tabla prescrita de acción|categoría|evidencia|solución|estado, un explícito "no-go, 9 needs_script abiertos", y lookup_model_history fijando account.invoice a account.move a partir de Odoo 13.0 con la nota del filtro move_type, además de una vista previa verificada de POST /json/2/sale.order/search_read. En contraste, las expresiones regulares de analyze_upgrade_log omitieron silenciosamente dos de las once líneas de error que mi línea base en prosa capturó ("Model acme.commission.rule references undefined model account.invoice" y "dependency website_theme_install not found"), y calificaron la línea en cascada "Failed to load registry" como su propio elemento needs_script, por lo que seguir la salida de la herramienta literalmente produce una lista de trabajo más delgada que leer el registro uno mismo.

Probado el: 2026-07-21 · Claude Code 2.x (agent harness)

Instalación

git clone --depth 1 https://github.com/tuanle96/mcp-odoo.git /tmp/odoo-migration-copilot-src
mkdir -p ~/.claude/skills
cp -R /tmp/odoo-migration-copilot-src/skills/odoo-migration-copilot ~/.claude/skills/odoo-migration-copilot
# REQUIRED, not optional: the skill is only a playbook — every step calls a tool from the
# odoo-mcp MCP server. Without that server connected the skill has nothing to run.
#   uvx odoo-mcp --setup      # prints the MCP client config snippet
# Needs Odoo connection env vars (ODOO_URL / ODOO_DB / ODOO_USER / ODOO_PASSWORD or API key).
# Phase 1 addon audit additionally needs ODOO_ADDONS_PATHS pointing at your custom addon tree.
# Sibling skill referenced by Phase 1 step 4 (install it too if you want the data gate):
#   cp -R /tmp/odoo-migration-copilot-src/skills/odoo-data-quality-gate ~/.claude/skills/odoo-data-quality-gate
# Upstream also offers: npx skills add erpipe-org/mcp-odoo  (installs all 4 skills in the pack)

Comandos y prompts de ejemplo

/odoo-migration-copilotConvierte registros de actualización de Odoo y escaneos de addons en una lista de trabajo clasificada a través del servidor odoo-mcp

Los skills se activan con peticiones en lenguaje natural, sin comandos que memorizar. Tras instalarlo, prompts como estos lo activan (en inglés):

Plan our Odoo upgrade from 16 to 18
Fix these broken upgrade log errors
Preview the JSON-2 payload changes for our upgrade

Informe completo →