mcp/keboola-mcp
Keboola MCP Server 是连接您的Keboola项目与现代AI工具的开源桥梁。
让 AI 帮你使用轩辕镜像？ · 展开查看说明 · 点击收起说明
如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。
只需在 AI 对话中先发送下面这句话即可：
请先完整阅读并严格遵守以下文档中的全部规则与要求：
https://xuanyuan.cloud/agents.md
在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。查看 agents.md 用法指南与完整示范。国内用户首推 元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。 若 AI 无法访问外链，可 打开说明文档 复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。
Keboola MCP Server
Keboola MCP Server 是连接您的Keboola项目与现代AI工具的开源桥梁。
https://www.anthropic.com/news/model-context-protocol
MCP信息
| 属性 | 详情 |
|---|---|
| Docker镜像 | https://hub.docker.com/repository/docker/mcp/keboola-mcp |
| 作者 | https://github.com/keboola |
| 仓库 | https://github.com/keboola/mcp-server |
镜像构建信息
| 属性 | 详情 |
|---|---|
| Dockerfile | https://github.com/keboola/mcp-server/blob/edac338db26ba0f2f72747c4430d9cf8b***e9/Dockerfile |
| Docker镜像构建者 | Docker Inc. |
| Docker Scout健康评分 | !https://api.scout.docker.com/v1/policy/insights/org-image-score/badge/mcp/keboola-mcp |
| 验证签名 | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/keboola-mcp --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
| 许可证 | MIT License |
可用工具（33个）
| 服务器提供的工具 | 简短描述 |
|---|---|
add_config_row | 在指定的configuration_id中创建组件配置行，使用指定的名称、组件ID、配置JSON和描述。 |
create_config | 使用指定的名称、组件ID、配置JSON和描述创建根组件配置。 |
create_flow | 在Keboola中创建新的流程配置。 |
create_oauth_url | 为Keboola组件配置生成OAuth授权URL。 |
create_sql_transformation | 使用指定的名称、遵循当前SQL方言的SQL查询、详细描述和创建的表名列表创建SQL转换。 |
docs_query | 使用Keboola文档作为来源回答问题。 |
find_component_id | 返回与给定查询匹配的组件ID列表。 |
get_bucket | 获取特定存储桶的详细信息。 |
get_component | 根据组件ID获取特定组件的信息。 |
get_config | 获取特定组件/转换配置的信息。 |
get_config_examples | 检索特定组件的示例配置。 |
get_flow | 获取特定流程配置的详细信息。 |
get_flow_schema | 返回定义流程配置结构的JSON模式。 |
get_job | 检索特定作业的详细信息（由job_id标识），包括其状态、参数、结果和任何相关元数据。 |
get_project_info | 返回从多个端点提取的结构化项目信息。 |
get_sql_dialect | 获取Keboola项目底层数据库使用的SQL方言名称。 |
get_table | 获取特定表的详细信息，包括其数据库标识符和列信息。 |
list_buckets | 检索项目中所有存储桶的信息。 |
list_configs | 检索项目中存在的组件配置，可选择按组件类型或特定组件ID筛选。 |
list_flows | 检索项目中的流程配置。 |
list_jobs | 检索项目中的所有作业，或按特定component_id或config_id筛选作业，并可选择按状态筛选。 |
list_tables | 检索特定存储桶中的所有表及其基本信息。 |
list_transformations | 检索项目中的转换配置，可选择按特定转换ID筛选。 |
query_data | 执行SQL SELECT查询以从底层数据库获取数据。 |
run_job | 为给定的组件或转换启动新作业。 |
search | 在当前项目的生产分支中搜索名称与给定前缀匹配的Keboola项目，可选择按项目类型缩小范围、限制数量和分页。 |
update_bucket_description | 更新给定Keboola存储桶的描述。 |
update_column_description | 更新Keboola表中给定列的描述。 |
update_config | 使用给定的组件ID和配置ID更新特定的根组件配置。 |
update_config_row | 在指定的configuration_id中更新特定的组件配置行，使用指定的名称、组件ID、配置JSON和描述。 |
update_flow | 更新Keboola中的现有流程配置。 |
update_sql_transformation | 更新现有的SQL转换配置，可选择更新描述和禁用配置。 |
update_table_description | 更新给定Keboola表的描述。 |
工具详情
工具：add_config_row
在指定的configuration_id中创建组件配置行，使用指定的名称、组件ID、配置JSON和描述。
注意事项：
- 配置JSON对象必须遵循指定组件的row_configuration_schema。
- 确保配置参数始终遵循row_configuration_schema，可通过component_detail工具获取。
- 配置JSON对象应遵循组件的配置示例（如果有）。
使用场景：
- 当您想要为特定组件配置创建新的行配置时使用。
示例：
- 用户输入：
为组件X创建带有这些设置的新配置行- 相应地设置component_id、configuration_id和配置参数
- 如果成功，返回创建的组件配置。
| 参数 | 类型 | 描述 |
|---|---|---|
component_id | string | 要为其创建配置的组件ID。 |
configuration_id | string | 要为其创建配置行的配置ID。 |
description | string | 组件配置的详细描述，解释其目的和功能。 |
name | string | 简短的描述性名称，总结组件配置的目的。 |
parameters | object | 组件行配置参数，遵循row_configuration_schema |
storage | object 可选 | 组件配置的表和/或文件输入/输出映射。仅对定义了表或文件输入映射的组件存在。 |
工具：create_config
使用指定的名称、组件ID、配置JSON和描述创建根组件配置。
注意事项：
- 配置JSON对象必须遵循指定组件的root_configuration_schema。
- 确保配置参数始终遵循root_configuration_schema，可通过component_detail工具获取。
- 配置JSON对象应遵循组件的配置示例（如果有）。
使用场景：
- 当您想要为特定组件创建新的根配置时使用。
示例：
- 用户输入：
为组件X创建带有这些设置的新配置- 相应地设置component_id和配置参数
- 如果成功，返回创建的组件配置。
| 参数 | 类型 | 描述 |
|---|---|---|
component_id | string | 要为其创建配置的组件ID。 |
description | string | 组件配置的详细描述，解释其目的和功能。 |
name | string | 简短的描述性名称，总结组件配置的目的。 |
parameters | object | 组件配置参数，遵循root_configuration_schema |
storage | object 可选 | 组件配置的表和/或文件输入/输出映射。仅对定义了表或文件输入映射的组件存在。 |
工具：create_flow
在Keboola中创建新的流程配置。 流程是一种特殊类型的Keboola组件，用于编排其他组件的执行。它定义了任务如何分组和排序——支持并行化和顺序执行的控制。 每个流程由以下部分组成：
- 任务：单个组件配置（例如，提取器、写入器、转换）。
- 阶段：并行运行的任务组。阶段本身根据依赖关系按顺序运行。
注意事项：
phases和tasks参数必须符合Keboola Flow JSON模式。- 每个任务和阶段必须至少包含：
id和name。 - 每个任务必须引用项目中现有的组件配置。
dependsOn阶段字段中的项目引用其他阶段的ID。- 响应中包含的链接应始终呈现给用户。
使用场景： 使用此工具自动化多步骤数据工作流。适用于：
- 创建ETL/ELT编排。
- 协调组件之间的依赖关系。
- 构建并行和顺序任务执行结构。
示例：
- 用户输入：编排我所有的JIRA提取器。
- 在
tasks参数中填写JIRA提取器的任务 - 确定JIRA提取器之间的依赖关系
- 通过将任务分组到阶段来填写
phases参数
- 在
| 参数 | 类型 | 描述 |
|---|---|---|
description | string | 流程目的的详细描述。 |
name | string | 流程的简短描述性名称。 |
phases | array | 阶段定义列表。 |
tasks | array | 任务定义列表。 |
工具：create_oauth_url
为Keboola组件配置生成OAuth授权URL。
使用此工具时，您的响应应非常简洁。只需引导用户点击授权链接。
请注意，此工具应在创建需要OAuth的组件配置后专门调用，例如keboola.ex-google-analytics-v4和keboola.ex-gmail。
| 参数 | 类型 | 描述 |
|---|---|---|
component_id | string | 要授予访问权限的组件ID（例如，"keboola.ex-google-analytics-v4"）。 |
config_id | string | 组件的配置ID。 |
工具：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转换配置。
| 参数 | 类型 | 描述 |
|---|---|---|
description | string | SQL转换的详细描述，捕获用户意图、解释SQL查询和预期输出。 |
name | string | SQL转换的简短描述性名称，总结其目的。 |
sql_code_blocks | array | SQL查询代码块列表，每个包含描述性名称和一系列语义相关的独立可执行sql_statements，使用当前SQL方言编写。 |
created_table_names | array 可选 | 如果SQL查询语句中生成了表，则为创建的表名列表（例如，使用CREATE TABLE ...）。 |
工具：docs_query
使用Keboola文档作为来源回答问题。
| 参数 | 类型 | 描述 |
|---|---|---|
query | string | 要在文档中搜索的自然语言查询。 |
工具：find_component_id
返回与给定查询匹配的组件ID列表。
使用场景：
- 当您想要找到特定用途的组件时使用。
示例：
- 用户输入：
我正在寻找Salesforce提取器组件- 返回与查询匹配的组件ID列表，按相关性/最佳匹配排序。
| 参数 | 类型 | 描述 |
|---|---|---|
query | string | 用于查找所需组件的自然语言查询。 |
工具：get_bucket
获取特定存储桶的详细信息。
| 参数 | 类型 | 描述 |
|---|---|---|
bucket_id | string | 存储桶的唯一ID。 |
工具：get_component
根据组件ID获取特定组件的信息。
使用场景：
- 当您想要查看特定组件的详细信息以获取其文档、配置模式等时使用。特别是在用户要求创建或更新组件配置的情况下。此工具主要供代理内部使用。
示例：
- 用户输入：
为x创建通用提取器配置- 如果知道component_id，则设置；否则通过find_component_id或docs use工具查找component_id并设置
- 返回组件信息
| 参数 | 类型 | 描述 |
|---|---|---|
component_id | string | 组件/转换的ID |
工具：get_config
获取特定组件/转换配置的信息。
使用场景：
- 当您想要查看特定组件/转换的配置时使用。
示例：
- 用户输入：
给我此配置的详细信息- 如果知道，将component_id和configuration_id设置为特定组件/转换ID和配置ID
- 返回组件/转换配置对
| 参数 | 类型 | 描述 |
|---|---|---|
component_id | string | 组件/转换的ID |
configuration_id | string | 组件/转换配置的ID |
工具：get_config_examples
检索特定组件的示例配置。
使用场景：
- 当您想要查看特定组件的示例配置时使用。
示例：
- 用户输入：
显示组件X的示例配置- 相应地设置component_id参数
- 返回Markdown格式的配置示例字符串
| 参数 | 类型 | 描述 |
|---|---|---|
component_id | string | 要获取配置示例的组件ID。 |
工具：get_flow
获取特定流程配置的详细信息。
| 参数 | 类型 | 描述 |
|---|---|---|
configuration_id | string | 要检索的流程配置ID。 |
工具：get_flow_schema
返回定义流程配置结构的JSON模式。
工具：get_job
检索特定作业的详细信息（由job_id标识），包括其状态、参数、结果和任何相关元数据。
示例：
- 如果job_id = "123"，则检索ID为"123"的作业详情。
| 参数 | 类型 | 描述 |
|---|---|---|
job_id | string | 要检索详情的作业的唯一标识符。 |
工具：get_project_info
返回从多个端点提取的结构化项目信息。
工具：get_sql_dialect
获取Keboola项目底层数据库使用的SQL方言名称。
工具：get_table
获取特定表的详细信息，包括其数据库标识符和列信息。
| 参数 | 类型 | 描述 |
|---|---|---|
table_id | string | 表的唯一ID。 |
工具：list_buckets
检索项目中所有存储桶的信息。
工具：list_configs
检索项目中存在的组件配置，可选择按组件类型或特定组件ID筛选。如果提供了component_ids，则仅检索由这些ID标识的组件，忽略component_types。
使用场景：
- 当您想要查看项目中给定component_types的组件配置时使用。
- 当您想要查看项目中给定component_ids的组件配置时使用。
示例：
- 用户输入：
给我项目中的所有组件- 返回项目中的所有组件配置
- 用户输入：
列出我项目中的所有提取器组件- 将types设置为["extractor"]
- 返回项目中的所有提取器组件配置
- 用户输入：
给我以下组件的配置
镜像拉取方式
您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问 标签列表页面。
轩辕镜像加速拉取命令点我查看更多 keboola-mcp 镜像标签
docker pull docker.xuanyuan.run/mcp/keboola-mcp:<标签>
DockerHub 原生拉取命令
docker pull mcp/keboola-mcp:<标签>
镜像拉取常见问题
功能
错误码
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"