Contribuir y licencia¶

Name: MCP-Odoo-Tools
Author: Transgenia (Centrum Transgenia S.A.S. de C.V.)

Gracias por ayudar a mejorar MCP-Odoo-Tools.

Reglas base¶

Licencia: las contribuciones se aceptan bajo licencia MIT.
Clean-room: no copies código de proyectos MCP de Odoo con licencia AGPL. Apóyate solo en las interfaces públicas XML-RPC/JSON-RPC de Odoo y en los nombres públicos de modelos/campos.
Alcance: este repositorio es el núcleo genérico público. Los motores de localización, gobernanza o específicos de un cliente (CFDI, compuertas de aprobación, respaldos, etc.) viven en otro lugar.

Servidor (Python)¶

cd server
python -m venv .venv && . .venv/bin/activate   # o usa uv
pip install -e ".[dev,cache]"
ruff check src tests
pytest -q

¿Cambias un comportamiento entre versiones? Edita src/odoo_mcp/compat/deltas.py (dato) y añade una fila a tests/test_compat_resolve.py. Las fronteras que no puedas verificar en vivo se comentan como "best-effort".
¿Herramienta nueva? Regístrala en src/odoo_mcp/tools/ con el decorador registry y enruta los nombres de modelo/campo por compat antes del ORM.

CLI (TypeScript)¶

cd cli && npm install && npm run build

Pull requests¶

Mantén los cambios enfocados; incluye pruebas para la lógica.
Actualiza docs/compat-matrix.md cuando cambie el mapa de deltas.
Anota cualquier versión/edición de Odoo nueva contra la que hayas verificado.

Licencia¶

MIT © Transgenia (Centrum Transgenia S.A.S. de C.V.). Ver LICENSE y NOTICE para las atribuciones de terceros.

Atribuciones¶

odoo-agent (MIT) — de Francisco Ramírez. Se reutilizan la CLI XML-RPC de TypeScript (cli/), la definición del agente Odoo genérico (agents/odoo.md, adaptada), el contexto de conocimiento de dominio y el patrón del hook SessionStart (adaptado).

Declaración clean-room¶

El servidor MCP en Python (server/) es una implementación original e independiente. No copia ni adapta código de ningún proyecto MCP de Odoo con licencia AGPL (incluidos rosenvladimirov/odoo-claude-mcp o sus forks). Se apoya únicamente en las interfaces XML-RPC/JSON-RPC públicamente documentadas de Odoo y en la nomenclatura pública de modelos/campos, que no están sujetas a derechos de autor. Cualquier similitud de comportamiento refleja esas interfaces públicas, no código compartido.

Marca Odoo

"Odoo" es una marca registrada de Odoo S.A. Este proyecto es una herramienta independiente y orientada a la comunidad, no afiliada ni respaldada por Odoo S.A.