Odoo MCP Server

Servidor MCP de Odoo

Un servidor de Model Context Protocol (MCP) que proporciona a Claude acceso directo a las capacidades del sistema ERP de Odoo. Perfecto para empresas que utilizan Odoo para gestionar sus operaciones mediante interacciones en lenguaje natural.

🚀 Características

📦 Gestión de Inventario

• Obtener niveles de inventario actuales e información de existencias
• Buscar detalles y especificaciones de productos
• Monitorear movimientos de existencias y disponibilidad
• Crear ajustes de inventario (próximamente)

🛒 Gestión de Compras

• Ver y filtrar órdenes de compra por estado
• Obtener información de proveedores/vendedores y contactos
• Análisis y reportes de compras
• Crear nuevas órdenes de compra (versión simplificada)

🏭 Manufactura (MRP)

• Ver órdenes de manufactura y cronogramas de producción
• Obtener información de Bill of Materials (BOM)
• Monitorear centros de trabajo y capacidad
• Resumen de planificación de producción
• Crear órdenes de manufactura (versión simplificada)

🛠️ Instalación y Configuración

Requisitos previos

• Go 1.21 o superior
• Acceso a una instancia de Odoo 17
• Base de datos PostgreSQL (opcional para acceso directo a la base de datos)

1. Clonar y Compilar

git clone <repository-url>
cd odoo-mcp-server
go mod tidy
go build -o odoo-mcp-server

2. Configuración

Copie la configuración de ejemplo y edítela con los detalles de conexión de su Odoo:

cp config.yaml.example config.yaml
vim config.yaml

La configuración debe contener:

odoo:
  url: "https://your-odoo-server.com"
  database: "your_database_name"
  username: "your_username"
  password: "your_password"

discord:
  webhook_url: "https://discord.com/api/webhooks/YOUR_ID/YOUR_TOKEN"

webhook:
  port: "8080"
  enabled: true

3. Compilar Servidores

./build.sh

4. Probar Conexión

# Test MCP Server
./odoo-mcp-server

# Test Webhook Server (for Discord notifications)
./odoo-webhook-server

🎯 Uso con Claude (Cursor)

Configurar MCP de Cursor

Agregue a la configuración de Cursor o cree .cursor-mcp.json:

{
  "mcpServers": {
    "odoo": {
      "command": "/path/to/your/odoo-mcp-server",
      "args": [],
      "env": {}
    }
  }
}

Consultas de Ejemplo

Gestión de Inventario:

"Show me current inventory levels for all products"
"What's the stock level for product ABC123?"
"Get product information for knockdown houses"

Gestión de Compras:

"Show me recent purchase orders"
"List all vendors/suppliers"
"Get purchase analytics for this month"
"Find vendor information for Company XYZ"

Manufactura:

"Show manufacturing orders in progress"
"Get BOM information for product DEF456"
"What's the current production planning?"
"Show me all work centers and their capacity"

🏗️ Herramientas Disponibles

Herramientas de Inventario - ข้อมูลสินค้าและสต๊อก

• get_inventory_levels - ดูระดับสต๊อกปัจจุบัน
• get_product_info - ข้อมูลสินค้าแบบละเอียด
• create_inventory_adjustment - ปรับปรุงสต๊อก (กำลังพัฒนา)

Herramientas de Compra - การจัดซื้อ

• get_purchase_orders - ดูใบสั่งซื้อ
• create_purchase_order - สร้างใบสั่งซื้อใหม่
• get_vendor_info - ข้อมูลผู้ขาย/ซัพพลายเออร์
• get_purchase_analytics - รายงานการจัดซื้อ

Herramientas de MRP - การผลิต

• get_manufacturing_orders - ดูใบสั่งผลิต
• get_bom_info - ข้อมูล Bill of Materials
• create_manufacturing_order - สร้างใบสั่งผลิต
• get_work_centers - ข้อมูลศูนย์การทำงาน
• get_production_planning - แผนการผลิต

🔧 Arquitectura

Claude (Cursor) ←→ MCP Protocol ←→ Go Server ←→ Odoo XML-RPC API
                                              ↓
                                         PostgreSQL DB

📊 Perfecto para Negocios de Knock-Down

Este servidor MCP está especialmente diseñado para empresas que manejan:

• Casas/edificios knock-down (บ้านน็อคดาวน์)
• Muebles/gabinetes knock-down (ตู้น็อคดาวน์)
• Productos de construcción modular
• Productos que requieren ensamblaje

Casos de Uso Empresariales

• Planificación de Inventario: "¿Cuántos marcos de casa de 3x4 metros tenemos en stock?"
• Planificación de Compras: "Crea una orden de compra para herrajes de gabinetes del Proveedor ABC"
• Programación de Producción: "¿Cuál es nuestro cronograma de manufactura para la próxima semana?"
• Gestión de Proveedores: "Muéstrame todos los proveedores de componentes de acero"

🚦 Estado y Hoja de Ruta

✅ Completado

• Implementación básica del protocolo MCP
• Integración XML-RPC con Odoo
• Herramientas principales de inventario, compras y MRP
• Gestión de configuración
• Manejo de errores y registro de actividades

🔄 En Progreso

• Listado mejorado de componentes BOM
• Flujo completo de creación de órdenes de compra
• Creación completa de órdenes de manufactura
• Consultas directas a PostgreSQL para rendimiento

📋 Planificado

• Gestión de órdenes de venta
• Integración contable
• Análisis avanzados y paneles de control
• Soporte multiempresa
• Mapeo de campos personalizados

🤝 Contribuciones

¡Siéntase libre de contribuir! Este está diseñado para ser una integración integral de Odoo MCP.

📝 Licencia

Licencia MIT - ¡Úselo libremente para sus necesidades de automatización empresarial!

---

เพื่อธุรกิจของคุณแอ๋ม - ¡De su amigo programador! 🎪 # odoo-mcp-server