mcp/keboola-mcp

Keboola MCP Server

Keboola MCP Server 是连接您的Keboola项目与现代AI工具的开源桥梁。

什么是MCP Server？

MCP信息

镜像构建信息

可用工具（33个）

---

工具详情

工具：add_config_row

在指定的configuration_id中创建组件配置行，使用指定的名称、组件ID、配置JSON和描述。

注意事项：

• 配置JSON对象必须遵循指定组件的row_configuration_schema。
• 确保配置参数始终遵循row_configuration_schema，可通过component_detail工具获取。
• 配置JSON对象应遵循组件的配置示例（如果有）。

使用场景：

• 当您想要为特定组件配置创建新的行配置时使用。

示例：

• 用户输入：为组件X创建带有这些设置的新配置行
  • 相应地设置component_id、configuration_id和配置参数
  • 如果成功，返回创建的组件配置。

---

工具：create_config

使用指定的名称、组件ID、配置JSON和描述创建根组件配置。

注意事项：

• 配置JSON对象必须遵循指定组件的root_configuration_schema。
• 确保配置参数始终遵循root_configuration_schema，可通过component_detail工具获取。
• 配置JSON对象应遵循组件的配置示例（如果有）。

使用场景：

• 当您想要为特定组件创建新的根配置时使用。

示例：

• 用户输入：为组件X创建带有这些设置的新配置
  • 相应地设置component_id和配置参数
  • 如果成功，返回创建的组件配置。

---

工具：create_flow

在Keboola中创建新的流程配置。 流程是一种特殊类型的Keboola组件，用于编排其他组件的执行。它定义了任务如何分组和排序——支持并行化和顺序执行的控制。 每个流程由以下部分组成：

• 任务：单个组件配置（例如，提取器、写入器、转换）。
• 阶段：并行运行的任务组。阶段本身根据依赖关系按顺序运行。

注意事项：

• phases和tasks参数必须符合Keboola Flow JSON模式。
• 每个任务和阶段必须至少包含：id和name。
• 每个任务必须引用项目中现有的组件配置。
• dependsOn阶段字段中的项目引用其他阶段的ID。
• 响应中包含的链接应始终呈现给用户。

使用场景： 使用此工具自动化多步骤数据工作流。适用于：

• 创建ETL/ELT编排。
• 协调组件之间的依赖关系。
• 构建并行和顺序任务执行结构。

示例：

• 用户输入：编排我所有的JIRA提取器。
  • 在tasks参数中填写JIRA提取器的任务
  • 确定JIRA提取器之间的依赖关系
  • 通过将任务分组到阶段来填写phases参数

---

工具：create_oauth_url

为Keboola组件配置生成OAuth授权URL。

使用此工具时，您的响应应非常简洁。只需引导用户点击授权链接。

请注意，此工具应在创建需要OAuth的组件配置后专门调用，例如keboola.ex-google-analytics-v4和keboola.ex-gmail。

---

工具：create_sql_transformation

使用指定的名称、遵循当前SQL方言的SQL查询、详细描述和创建的表名列表创建SQL转换。

注意事项：

• 默认情况下，SQL转换必须至少创建一个表以产生结果；仅当用户明确指示不需要创建表时才省略。
• 每个SQL代码块必须包含反映其目的的描述性名称，并将一个或多个可执行的语义相关SQL语句分组。
• 代码块中的每个SQL查询语句必须可执行，并遵循当前SQL方言，可使用适当的工具检索。
• 在SQL查询中引用输入表时，使用完全限定的表名，可使用工具获取表信息。完全限定的表名可在该工具的响应中找到。
• 在SQL查询中创建新表时（例如CREATE TABLE ...），仅使用带引号的表名（不带完全限定表名），并将不带引号的表名添加到created_table_names列表中。
• 除非用户另有说明，转换名称和描述基于SQL查询和用户意图生成。

使用场景：

• 当您想要创建新的SQL转换时使用。

示例：

• 用户输入：能否根据此SQL查询创建新转换？
  • 将sql_code_blocks设置为查询，并相应设置其他参数
  • 如果成功，返回创建的SQL转换配置。
• 用户输入：生成一个SQL转换来[用户意图]
  • 基于[用户意图]将sql_code_blocks设置为查询，并相应设置其他参数
  • 如果成功，返回创建的SQL转换配置。

---

工具：docs_query

使用Keboola文档作为来源回答问题。

---

工具：find_component_id

返回与给定查询匹配的组件ID列表。

使用场景：

• 当您想要找到特定用途的组件时使用。

示例：

• 用户输入：我正在寻找Salesforce提取器组件
  • 返回与查询匹配的组件ID列表，按相关性/最佳匹配排序。

---

工具：get_bucket

获取特定存储桶的详细信息。

---

工具：get_component

根据组件ID获取特定组件的信息。

使用场景：

• 当您想要查看特定组件的详细信息以获取其文档、配置模式等时使用。特别是在用户要求创建或更新组件配置的情况下。此工具主要供代理内部使用。

示例：

• 用户输入：为x创建通用提取器配置
  • 如果知道component_id，则设置；否则通过find_component_id或docs use工具查找component_id并设置
  • 返回组件信息

---

工具：get_config

获取特定组件/转换配置的信息。

使用场景：

• 当您想要查看特定组件/转换的配置时使用。

示例：

• 用户输入：给我此配置的详细信息
  • 如果知道，将component_id和configuration_id设置为特定组件/转换ID和配置ID
  • 返回组件/转换配置对

---

工具：get_config_examples

检索特定组件的示例配置。

使用场景：

• 当您想要查看特定组件的示例配置时使用。

示例：

• 用户输入：显示组件X的示例配置
  • 相应地设置component_id参数
  • 返回Markdown格式的配置示例字符串

---

工具：get_flow

获取特定流程配置的详细信息。

---

工具：get_flow_schema

返回定义流程配置结构的JSON模式。

---

工具：get_job

检索特定作业的详细信息（由job_id标识），包括其状态、参数、结果和任何相关元数据。

示例：

• 如果job_id = "123"，则检索ID为"123"的作业详情。

---

工具：get_project_info

返回从多个端点提取的结构化项目信息。

---

工具：get_sql_dialect

获取Keboola项目底层数据库使用的SQL方言名称。

---

工具：get_table

获取特定表的详细信息，包括其数据库标识符和列信息。

---

工具：list_buckets

检索项目中所有存储桶的信息。

---

工具：list_configs

检索项目中存在的组件配置，可选择按组件类型或特定组件ID筛选。如果提供了component_ids，则仅检索由这些ID标识的组件，忽略component_types。

使用场景：

• 当您想要查看项目中给定component_types的组件配置时使用。
• 当您想要查看项目中给定component_ids的组件配置时使用。

示例：

• 用户输入：给我项目中的所有组件
  • 返回项目中的所有组件配置
• 用户输入：列出我项目中的所有提取器组件
  • 将types设置为["extractor"]
  • 返回项目中的所有提取器组件配置
• 用户输入：给我以下组件的配置