Odoo MCP Improved

Odoo MCP Improved

---

📋 Tabla de Contenidos

• Resumen
• Características
• Instalación
• Configuración
• Uso
• Referencia de Herramientas
• Referencia de Recursos
• Prompts
• Integración con Claude Desktop
• Licencia

---

🔍 Resumen

Odoo MCP Improved es una implementación integral del Model Context Protocol (MCP) para sistemas ERP de Odoo. Proporciona un puente entre modelos de lenguaje grandes como Claude y tu instancia de Odoo, permitiendo que los asistentes de IA interactúen directamente con tus datos y procesos de negocio.

Esta versión extendida mejora la implementación original de MCP-Odoo con herramientas y recursos avanzados para ventas, compras, gestión de inventario y contabilidad, convirtiéndola en una solución potente para operaciones empresariales asistidas por IA.

---

✨ Características

Capacidades Principales

• Integración fluida con Odoo: Conéctate directamente a tu instancia de Odoo mediante XML-RPC
• Acceso integral a datos: Consulta y manipula datos en todos los módulos de Odoo
• Arquitectura modular: Fácilmente extensible con nuevas herramientas y recursos
• Manejo robusto de errores: Mensajes de error claros y validación para una operación confiable

Soporte de Dominios de Negocio

• Gestión de Ventas: Seguimiento de pedidos, información de clientes y análisis de rendimiento
• Gestión de Compras: Gestión de proveedores, procesamiento de pedidos y métricas de rendimiento
• Gestión de Inventario: Monitoreo de existencias, ajustes de inventario y análisis de rotación
• Contabilidad: Informes financieros, asientos de diario y análisis de ratios

Funcionalidad Avanzada

• Herramientas Analíticas: Capacidades de inteligencia empresarial en todos los dominios
• Prompts Especializados: Prompts preconfigurados para escenarios empresariales comunes
• URIs de Recursos: Acceso estandarizado a datos de Odoo mediante patrones de URI
• Optimización de Rendimiento: Caché y recuperación eficiente de datos

---

📦 Instalación

Usando pip

pip install odoo-mcp-improved

🚀 Uso

Ejecutando el Servidor

# Using the module
python -m odoo_mcp

Ejemplos de Interacción

# Sales Analysis
Using the Odoo MCP, analyze our sales performance for the last quarter and identify our top-selling products.

# Inventory Check
Check the current stock levels for product XYZ across all warehouses.

# Financial Analysis
Calculate our current liquidity and profitability ratios based on the latest financial data.

# Customer Insights
Provide insights on customer ABC's purchase history and payment patterns.

---

🤖 Integración con Claude Desktop

Agrega lo siguiente a tu claude_desktop_config.json:

{
  "mcpServers": {
    "odoo": {
      "command": "python",
      "args": ["-m", "odoo_mcp"],
      "env": {
        "ODOO_URL": "https://your-odoo-instance.com",
        "ODOO_DB": "your_database",
        "ODOO_USERNAME": "your_username",
        "ODOO_PASSWORD": "your_password"
      }
    }
  }
}

---

🛠️ Referencia de Herramientas

Herramientas de Ventas

Herramienta	Descripción
search_sales_orders	Busca pedidos de venta con filtrado avanzado
create_sales_order	Crea un nuevo pedido de venta
analyze_sales_performance	Analiza el rendimiento de ventas por período, producto o cliente
get_customer_insights	Obtén información detallada sobre un cliente específico

Herramientas de Compras

Herramienta	Descripción
search_purchase_orders	Busca pedidos de compra con filtrado avanzado
create_purchase_order	Crea un nuevo pedido de compra
analyze_supplier_performance	Analiza métricas de rendimiento de proveedores

Herramientas de Inventario

Herramienta	Descripción
check_product_availability	Verifica la disponibilidad de existencias de productos
create_inventory_adjustment	Crea asientos de ajuste de inventario
analyze_inventory_turnover	Calcula y analiza métricas de rotación de inventario

Herramientas de Contabilidad

Herramienta	Descripción
search_journal_entries	Busca asientos de diario contables
create_journal_entry	Crea un nuevo asiento de diario
analyze_financial_ratios	Calcula ratios financieros clave

---

🔗 Referencia de Recursos

Recursos de Ventas

URI	Descripción
odoo://sales/orders	Lista pedidos de venta
odoo://sales/order/{order_id}	Obtén detalles de un pedido de venta específico
odoo://sales/products	Lista productos vendibles
odoo://sales/customers	Lista clientes

Recursos de Compras

URI	Descripción
odoo://purchase/orders	Lista pedidos de compra
odoo://purchase/order/{order_id}	Obtén detalles de un pedido de compra específico
odoo://purchase/suppliers	Lista proveedores

Recursos de Inventario

URI	Descripción
odoo://inventory/products	Lista productos en inventario
odoo://inventory/stock/{location_id}	Obtén niveles de existencias en una ubicación específica
odoo://inventory/movements	Lista movimientos de inventario

Recursos de Contabilidad

URI	Descripción
odoo://accounting/accounts	Lista cuentas contables
odoo://accounting/journal_entries	Lista asientos de diario
odoo://accounting/reports/{report_type}	Obtén informes financieros

---

💬 Prompts

Odoo MCP Improved incluye prompts especializados para diferentes escenarios empresariales:

Prompts de Análisis de Ventas

• Análisis de tendencias de ventas
• Segmentación de clientes
• Evaluación de rendimiento de productos
• Rendimiento del equipo de ventas

Prompts de Gestión de Inventario

• Optimización de existencias
• Sugerencias de reabastecimiento
• Análisis de eficiencia de almacén
• Patrones de movimiento de productos

Prompts de Recursos Humanos

• Planificación de personal
• Optimización de horarios
• Evaluación de rendimiento
• Asignación de recursos

Prompts de Análisis Financiero

• Interpretación de ratios
• Análisis de flujo de caja
• Análisis de variación presupuestaria
• Evaluación de salud financiera

---

📄 Licencia

Este proyecto está licenciado bajo la Licencia MIT - consulta el archivo LICENSE para más detalles.

Este repositorio es una extensión de mcp-odoo - Lê Anh Tuấn

---