Servidor MCP de Odoo

Una implementación de servidor MCP que se integra con los sistemas ERP de Odoo, lo que permite que los asistentes de IA interactúen con los datos y la funcionalidad de Odoo a través del Protocolo de Contexto de Modelo.

Características

• Integración completa con Odoo : acceso completo a los modelos, registros y métodos de Odoo
• Comunicación XML-RPC : Conexión segura a instancias de Odoo a través de XML-RPC
• Configuración flexible : Compatibilidad con archivos de configuración y variables de entorno
• Sistema de patrones de recursos : acceso basado en URI a las estructuras de datos de Odoo
• Manejo de errores : mensajes de error claros para problemas comunes de la API de Odoo
• Operaciones sin estado : ciclo limpio de solicitud/respuesta para una integración confiable

Herramientas

• registros de búsqueda
  • Buscar registros en cualquier modelo de Odoo
  • Entradas:
    • model (cadena): el nombre del modelo (por ejemplo, 'res.partner')
    • domain (matriz): dominio de búsqueda (por ejemplo, [['is_company', '=', true]])
    • fields (matriz opcional): campos opcionales para obtener
    • limit (número opcional): Número máximo de registros a devolver
  • Devoluciones: registros coincidentes con los campos solicitados
• leer_registro
  • Leer detalles de un registro específico
  • Entradas:
    • model (cadena): el nombre del modelo (por ejemplo, 'res.partner')
    • id (número): El ID del registro
    • fields (matriz opcional): campos opcionales para obtener
  • Devuelve: Registra datos con los campos solicitados
• crear_registro
  • Crear un nuevo registro en Odoo
  • Entradas:
    • model (cadena): el nombre del modelo (por ejemplo, 'res.partner')
    • values (objeto): Diccionario de valores de campo
  • Devuelve: Diccionario con el nuevo ID de registro
• actualizar_registro
  • Actualizar un registro existente
  • Entradas:
    • model (cadena): el nombre del modelo (por ejemplo, 'res.partner')
    • id (número): El ID del registro
    • values (objeto): Diccionario de valores de campo a actualizar
  • Devuelve: Diccionario que indica éxito
• eliminar_registro
  • Eliminar un registro de Odoo
  • Entradas:
    • model (cadena): el nombre del modelo (por ejemplo, 'res.partner')
    • id (número): El ID del registro
  • Devuelve: Diccionario que indica éxito
• método_de_ejecución
  • Ejecutar un método personalizado en un modelo de Odoo
  • Entradas:
    • model (cadena): el nombre del modelo (por ejemplo, 'res.partner')
    • method (cadena): Nombre del método a ejecutar
    • args (matriz opcional): argumentos posicionales
    • kwargs (objeto opcional): argumentos de palabras clave
  • Devuelve: Diccionario con el resultado del método
• obtener_campos_del_modelo
  • Obtener definiciones de campo para un modelo
  • Entradas:
    • model (cadena): el nombre del modelo (por ejemplo, 'res.partner')
  • Devuelve: Diccionario con definiciones de campos
• búsqueda_empleado
  • Buscar empleados por nombre.
  • Entradas:
    • name (cadena): el nombre (o parte del nombre) que se buscará.
    • limit (número opcional): el número máximo de resultados a devolver (predeterminado 20).
  • Devuelve: Lista de nombres e identificaciones de empleados coincidentes.
• buscar_vacaciones
  • Busca días festivos dentro de un rango de fechas específico.
  • Entradas:
    • start_date (cadena): Fecha de inicio en formato AAAA-MM-DD.
    • end_date (cadena): Fecha de finalización en formato AAAA-MM-DD.
    • employee_id (número opcional): ID de empleado opcional para filtrar días festivos.
  • Devoluciones: Listado de días festivos encontrados.

Recursos

• odoo://modelos
  • Enumera todos los modelos disponibles en el sistema Odoo
  • Devuelve: matriz JSON de información del modelo
• odoo://modelo/{nombre_del_modelo}
  • Obtenga información sobre un modelo específico, incluidos los campos
  • Ejemplo: odoo://model/res.partner
  • Devuelve: objeto JSON con metadatos del modelo y definiciones de campo
• odoo://registro/{nombre_del_modelo}/{id_del_registro}
  • Obtener un registro específico por ID
  • Ejemplo: odoo://record/res.partner/1
  • Devuelve: objeto JSON con datos de registro
• odoo://search/{nombre_del_modelo}/{dominio}
  • Buscar registros que coincidan con un dominio
  • Ejemplo: odoo://search/res.partner/[["is_company","=",true]]
  • Devuelve: matriz JSON de registros coincidentes (limitada a 10 de forma predeterminada)

Configuración

Configuración de la conexión a Odoo

1. Cree un archivo de configuración llamado odoo_config.json :

2. Alternativamente, utilice variables de entorno:
   • ODOO_URL : URL de su servidor Odoo
   • ODOO_DB : Nombre de la base de datos
   • ODOO_USERNAME : Nombre de usuario de inicio de sesión
   • ODOO_PASSWORD : Contraseña o clave API
   • ODOO_TIMEOUT : Tiempo de espera de conexión en segundos (predeterminado: 30)
   • ODOO_VERIFY_SSL : Si se deben verificar los certificados SSL (valor predeterminado: verdadero)
   • HTTP_PROXY : Fuerza la conexión ODOO a utilizar un proxy HTTP

Uso con Claude Desktop

Agregue esto a su claude_desktop_config.json :

Estibador

Instalación

Paquete Python

Ejecución del servidor

Construir

Compilación de Docker:

Pautas de formato de parámetros

Al utilizar las herramientas MCP para Odoo, preste atención a estas pautas de formato de parámetros:

1. Parámetro de dominio :
   • Se admiten los siguientes formatos de dominio:
     • Formato de lista: [["field", "operator", value], ...]
     • Formato del objeto: {"conditions": [{"field": "...", "operator": "...", "value": "..."}]}
     • Cadena JSON de cualquier formato
   • Ejemplos:
     • Formato de lista: [["is_company", "=", true]]
     • Formato del objeto: {"conditions": [{"field": "date_order", "operator": ">=", "value": "2025-03-01"}]}
     • Varias condiciones: [["date_order", ">=", "2025-03-01"], ["date_order", "<=", "2025-03-31"]]
2. Parámetros de campos :
   • Debe ser una matriz de nombres de campos: ["name", "email", "phone"]
   • El servidor intentará analizar las entradas de cadena como JSON

Licencia

Este servidor MCP tiene licencia MIT.