Servidor MCP de Gumloop

Servidor MCP para la API de Gumloop, que permite que los modelos de IA administren y ejecuten automatizaciones a través de una interfaz estandarizada.

Características

• Gestión de flujo : inicie automatizaciones y supervise su estado de ejecución

• Descubrimiento del espacio de trabajo : enumera los libros de trabajo disponibles y los flujos de automatización guardados

• Recuperación del esquema de entrada : obtenga información detallada sobre las entradas requeridas para los flujos

• Operaciones de archivos : Cargar y descargar archivos utilizados en automatizaciones

• Ejecución consciente del contexto : ejecute automatizaciones con parámetros de entrada específicos para las necesidades del usuario

Related MCP server: The Web MCP

Herramientas

startAutomation

Inicia una nueva ejecución de flujo para una automatización guardada específica.

Entradas:

• user_id (cadena): El ID del usuario que inicia el flujo

• saved_item_id (cadena): El ID del flujo guardado

• project_id (cadena, opcional): El ID del proyecto dentro del cual se ejecuta el flujo

• pipeline_inputs (matriz, opcional): Lista de entradas para el flujo

  • input_name (cadena): El parámetro 'input_name' de su nodo de entrada

  • value (cadena): el valor que se pasará al nodo de entrada

Devoluciones: Respuesta con detalles de ejecución, incluidos run_id, saved_item_id, workbook_id y URL

retrieveRunDetails

Recupera detalles sobre una ejecución de flujo específica.

Entradas:

• run_id (cadena): ID de la ejecución del flujo a recuperar

• user_id (cadena, opcional): El ID del usuario que inicia el flujo

• project_id (cadena, opcional): El ID del proyecto dentro del cual se ejecuta el flujo

Devoluciones: Respuesta con detalles de ejecución, incluidos estado, salidas, marcas de tiempo y registros

listSavedFlows

Recupera una lista de todos los flujos guardados para un usuario o proyecto.

Entradas:

• user_id (cadena, opcional): el ID del usuario para el que se enumerarán los elementos

• project_id (cadena, opcional): El ID del proyecto para el cual se enumerarán los elementos

Devoluciones: Respuesta con lista de flujos guardados y sus metadatos

listWorkbooks

Recupera una lista de todos los libros de trabajo y sus flujos guardados asociados.

Entradas:

• user_id (cadena, opcional): el ID del usuario para el cual se listarán los libros de trabajo

• project_id (cadena, opcional): El ID del proyecto para el cual se listarán los libros de trabajo

Devoluciones: Respuesta con lista de libros de trabajo y sus flujos guardados asociados

retrieveInputSchema

Recupera el esquema de entrada para un flujo guardado específico.

Entradas:

• saved_item_id (cadena): El ID del elemento guardado para el cual se recuperarán los esquemas de entrada

• user_id (cadena, opcional): ID del usuario que creó el flujo

• project_id (cadena, opcional): ID del proyecto bajo el cual se encuentra el flujo

Devuelve: Respuesta con lista de parámetros de entrada para el flujo

uploadFile

Sube un solo archivo a la plataforma Gumloop.

Entradas:

• file_name (cadena): El nombre del archivo que se cargará

• file_content (cadena): contenido codificado en Base64 del archivo

• user_id (cadena, opcional): El ID de usuario asociado con el archivo

• project_id (cadena, opcional): El ID del proyecto asociado con el archivo

Devoluciones: Respuesta con estado de éxito y nombre de archivo

uploadMultipleFiles

Sube varios archivos a la plataforma Gumloop en una sola solicitud.

Entradas:

• files (matriz): Matriz de objetos de archivo para cargar

  • file_name (cadena): El nombre del archivo que se cargará

  • file_content (cadena): contenido codificado en Base64 del archivo

• user_id (cadena, opcional): El ID de usuario asociado con los archivos

• project_id (cadena, opcional): El ID del proyecto asociado con los archivos

Devoluciones: Respuesta con estado de éxito y lista de nombres de archivos cargados

downloadFile

Descarga un archivo específico de la plataforma Gumloop.

Entradas:

• file_name (cadena): El nombre del archivo a descargar

• run_id (cadena): El ID de la ejecución del flujo asociado con el archivo

• saved_item_id (cadena): El ID del elemento guardado asociado con el archivo

• user_id (cadena, opcional): El ID de usuario asociado con la ejecución del flujo

• project_id (cadena, opcional): El ID del proyecto asociado con la ejecución del flujo

Devuelve: El contenido del archivo solicitado

downloadMultipleFiles

Descarga varios archivos de la plataforma Gumloop como un archivo zip.

Entradas:

• file_names (matriz): una matriz de nombres de archivos para descargar

• run_id (cadena): El ID de la ejecución del flujo asociado con los archivos

• user_id (cadena, opcional): El ID de usuario asociado con los archivos

• project_id (cadena, opcional): El ID del proyecto asociado con los archivos

• saved_item_id (cadena, opcional): El ID del elemento guardado asociado con los archivos

Devuelve: Archivo zip que contiene los archivos solicitados

Configuración

Clave API

Cree una clave API de Gumloop con acceso a las funciones requeridas:

1. Vaya a la configuración del espacio de trabajo de Gumloop

2. Generar una nueva clave API

3. Copiar la clave generada

Uso con Claude Desktop

Para usar esto con Claude Desktop, agregue lo siguiente a su claude_desktop_config.json :

Uso de NPX

{
  "mcpServers": {
    "gumloop": {
      "command": "npx",
      "args": [
        "-y",
        "gumloop-mcp-server"
      ],
      "env": {
        "GUMLOOP_API_KEY": "<YOUR_GUMLOOP_API_KEY>"
      }
    }
  }
}

Usando Docker

{
  "mcpServers": {
    "gumloop": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GUMLOOP_API_KEY",
        "gumloop-mcp-server"
      ],
      "env": {
        "GUMLOOP_API_KEY": "<YOUR_GUMLOOP_API_KEY>"
      }
    }
  }
}

Ejemplos

Iniciar una automatización

// Start a saved automation flow
const result = await agent.callTool("startAutomation", {
  user_id: "user123",
  saved_item_id: "flow456",
  pipeline_inputs: [
    {
      input_name: "search_query",
      value: "AI automation trends 2025"
    }
  ]
});

Comprobación del estado de ejecución

// Check the status of a running automation
const result = await agent.callTool("retrieveRunDetails", {
  run_id: "run789",
  user_id: "user123"
});

Listado de flujos disponibles

// Get all saved flows for a user
const result = await agent.callTool("listSavedFlows", {
  user_id: "user123"
});

Trabajar con archivos

// Upload a file to be used in an automation
const result = await agent.callTool("uploadFile", {
  user_id: "user123",
  file_name: "data.csv",
  file_content: "base64EncodedFileContent..."
});

Formato de respuesta

El servidor devuelve las respuestas de la API de Gumloop en formato JSON. A continuación, se muestra un ejemplo para recuperar los detalles de la ejecución:

{
  "user_id": "user123",
  "state": "RUNNING",
  "outputs": {},
  "created_ts": "2023-11-07T05:31:56Z",
  "finished_ts": null,
  "log": [
    "Starting automation flow...",
    "Processing input parameters...",
    "Executing node 1: Web Scraper..."
  ]
}

Limitaciones

• Las llamadas API están sujetas a los límites de velocidad y cuotas de uso de Gumloop

• Las cargas de archivos están limitadas al tamaño máximo permitido por la API de Gumloop

• Algunas funciones pueden requerir niveles de suscripción específicos

• El servidor requiere una clave API de Gumloop válida con los permisos adecuados

Construir

# Install dependencies
pnpm install

# Build the project
pnpm run build

# Start the server
pnpm start

Licencia

Este servidor MCP tiene licencia MIT.