Skip to main content
Glama
SaintsFlow

odoo-mcp

by SaintsFlow

odoo-mcp

Un servidor MCP para Odoo. Proporciona a un agente LLM acceso de lectura y escritura a socios, pedidos de venta, niveles de stock y facturas en una instancia de Odoo.

Estado: temprano. La lista de herramientas a continuación es el plan. No todo funciona todavía.

Por qué

Odoo es un ERP completo con una API amplia, lo que dificulta su uso por parte de un agente. Su API externa es XML-RPC con llamadas genéricas search_read y execute_kw, por lo que el agente necesitaría conocer los nombres de los modelos, los nombres de los campos y la sintaxis de dominio. Este servidor expone en su lugar un pequeño número de herramientas con nombre, cada una cubriendo una tarea que una persona realmente pediría.

Odoo Community se ejecuta en Docker con datos de demostración, por lo que todo se puede probar sin ningún sistema real.

Related MCP server: OdooSurface MCP

Herramientas

Herramienta

Qué hace

search_partners

buscar clientes y proveedores

get_sales_order

leer un pedido con sus líneas y estado

create_sales_order

crear un pedido en borrador para un socio

confirm_sales_order

confirmar un pedido en borrador

get_stock

cantidad actual disponible de un producto

list_invoices

facturas de un socio, filtradas por estado

Inicio rápido

docker compose up -d odoo db    # Odoo Community with demo data
cp .env.example .env
docker compose up mcp

Odoo tarda aproximadamente un minuto en inicializar su base de datos en el primer arranque.

Cómo funciona

El servidor se conecta a Odoo a través de XML-RPC. Cada herramienta construye el dominio y la lista de campos por sí misma, por lo que el agente nunca ve los internos de Odoo. Los resultados se recortan a los campos relevantes y se devuelven como registros planos.

Decisiones de diseño

Herramientas con nombre, no una herramienta de consulta genérica. Una única herramienta run_query sería más fácil de escribir y mucho peor de usar. Las herramientas con nombre llevan su propia validación y hacen obvio lo que el agente puede hacer.

Lectura y escritura están separadas. Las herramientas de escritura están marcadas en el esquema para que el cliente pueda requerir confirmación.

Los errores se traducen. Odoo lanza fallos con tracebacks largos. El servidor extrae el mensaje y lo devuelve en una forma en la que el agente pueda actuar.

Lo que aún no está aquí

  • paginación y límites de resultados

  • soporte multiempresa

  • pruebas contra una instancia de Odoo con datos

Licencia

MIT

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    Not graded
    maintenance
    Enables AI assistants to interact with Odoo ERP systems through natural language to search records, create entries, update data, and manage business operations. Supports secure authentication and configurable access controls for production environments.
    Mozilla Public 2.0
  • A
    license
    A
    quality
    A
    maintenance
    Enables AI agents to interact with Odoo ERP as the authenticated user, with tools for discovery, planning, and mutations bounded by user permissions.
    36
    23 npm
    2
    Apache 2.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI assistants to fully interact with Odoo ERP instances over XML-RPC, supporting read and write operations on any model without requiring Odoo module installation.
    5
    AGPL 3.0
  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI agents to interact with Odoo ERP through natural language, providing tools and prompts for data operations and record management.
    MIT