Gumloop MCP 服务器

Gumloop API 的 MCP 服务器，通过标准化接口使 AI 模型能够管理和执行自动化任务。

功能

• 流程管理：启动自动化并监控其执行状态
• 工作区发现：列出可用的工作簿和已保存的自动化流程
• 输入模式检索：获取关于流程所需输入的详细信息
• 文件操作：上传和下载用于自动化的文件
• 上下文感知执行：根据用户需求使用特定输入参数运行自动化

工具

startAutomation

为特定已保存的自动化启动一个新的流程运行。

输入:

• user_id (字符串)：发起流程的用户的 ID
• saved_item_id (字符串)：已保存流程的 ID
• project_id (字符串, 可选)：流程执行所在的项目 ID
• pipeline_inputs (数组, 可选)：流程的输入列表
  • input_name (字符串)：来自您的输入节点的 input_name 参数
  • value (字符串)：传递给输入节点的值

返回: 包含运行详情（如 run_id、saved_item_id、workbook_id 和 URL）的响应

retrieveRunDetails

检索特定流程运行的详情。

输入:

• run_id (字符串)：要检索的流程运行的 ID
• user_id (字符串, 可选)：发起流程的用户的 ID
• project_id (字符串, 可选)：流程执行所在的项目 ID

返回: 包含状态、输出、时间戳和日志等运行详情的响应

listSavedFlows

为用户或项目检索所有已保存的流程列表。

输入:

• user_id (字符串, 可选)：要列出项目的用户 ID
• project_id (字符串, 可选)：要列出项目的项目 ID

返回: 包含已保存流程及其元数据的响应

listWorkbooks

检索所有工作簿及其关联的已保存流程列表。

输入:

• user_id (字符串, 可选)：要列出工作簿的用户 ID
• project_id (字符串, 可选)：要列出工作簿的项目 ID

返回: 包含工作簿及其关联的已保存流程的响应

retrieveInputSchema

检索特定已保存流程的输入模式。

输入:

• saved_item_id (字符串)：要检索输入模式的已保存项的 ID
• user_id (字符串, 可选)：创建流程的用户 ID
• project_id (字符串, 可选)：流程所属的项目 ID

返回: 包含流程输入参数列表的响应

uploadFile

将单个文件上传到 Gumloop 平台。

输入:

• file_name (字符串)：要上传的文件名
• file_content (字符串)：文件的 Base64 编码内容
• user_id (字符串, 可选)：与文件关联的用户 ID
• project_id (字符串, 可选)：与文件关联的项目 ID

返回: 包含成功状态和文件名的响应

uploadMultipleFiles

在单个请求中将多个文件上传到 Gumloop 平台。

输入:

• files (数组)：要上传的文件对象数组
  • file_name (字符串)：要上传的文件名
  • file_content (字符串)：文件的 Base64 编码内容
• user_id (字符串, 可选)：与文件关联的用户 ID
• project_id (字符串, 可选)：与文件关联的项目 ID

返回: 包含成功状态和已上传文件名列表的响应

downloadFile

从 Gumloop 平台下载特定文件。

输入:

• file_name (字符串)：要下载的文件名
• run_id (字符串)：与文件关联的流程运行 ID
• saved_item_id (字符串)：与文件关联的已保存项 ID
• user_id (字符串, 可选)：与流程运行关联的用户 ID
• project_id (字符串, 可选)：与流程运行关联的项目 ID

返回: 请求的文件内容

downloadMultipleFiles从Gumloop平台下载多个文件作为zip存档。

输入：

• file_names (数组)：要下载的文件名数组
• run_id (字符串)：与文件关联的流程运行ID
• user_id (字符串, 可选)：与文件关联的用户ID
• project_id (字符串, 可选)：与文件关联的项目ID
• saved_item_id (字符串, 可选)：与文件关联的保存项ID

返回： 包含请求文件的zip文件

设置

API密钥

创建一个具有所需功能访问权限的Gumloop API密钥：

1. 前往 Gumloop工作区设置
2. 生成一个新的API密钥
3. 复制生成的密钥

与Claude Desktop一起使用

要与Claude Desktop一起使用，请将以下内容添加到您的claude_desktop_config.json中：

使用NPX

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

使用Docker

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

示例

启动自动化

javascript
// 启动已保存的自动化流程
const result = await agent.callTool("startAutomation", {
user_id: "user123",
saved_item_id: "flow456",
pipeline_inputs: [
{
input_name: "search_query",
value: "AI automation trends 2025"
}
]
});

检查运行状态

javascript
// 检查正在运行的自动化状态
const result = await agent.callTool("retrieveRunDetails", {
run_id: "run789",
user_id: "user123"
});

列出可用流程

javascript
// 获取用户的全部已保存流程
const result = await agent.callTool("listSavedFlows", {
user_id: "user123"
});

文件操作

javascript
// 上传将在自动化中使用的文件
const result = await agent.callTool("uploadFile", {
user_id: "user123",
file_name: "data.csv",
file_content: "base64EncodedFileContent..."
});

响应格式

服务器以JSON格式返回Gumloop API响应。以下是检索运行详情的一个示例：

json
{
"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..."
]
}

限制

• API调用受Gumloop的速率限制和使用配额约束
• 文件上传大小受限于Gumloop API允许的最大值
• 某些功能可能需要特定的订阅层级
• 服务器需要具有适当权限的有效Gumloop API密钥

构建

bash

安装依赖

pnpm install

构建项目

pnpm run build

启动服务器

pnpm start

许可证

此MCP服务器根据MIT许可证许可。