Keboola MCP Server

基本能力

产品定位

Keboola MCP Server 是一个用于与 Keboola Connection 平台交互的 MCP 服务器，主要用于数据管理和查询。

核心功能

1. 存储工具：获取和管理 Keboola 存储中的桶和表信息。
2. SQL 工具：执行 SQL 查询并获取 SQL 方言信息。
3. 组件工具：管理和查询 Keboola 组件和转换配置。
4. 作业工具：启动和管理 Keboola 作业。
5. 文档工具：使用 Keboola 文档作为来源回答问题。

适用场景

1. 需要从 Keboola Connection 平台查询和管理数据的场景。
2. 需要执行 SQL 查询并获取结果的场景。
3. 需要管理和监控 Keboola 作业的场景。
4. 需要访问 Keboola 文档以获取帮助的场景。

工具列表

1. 存储工具：
2. get_bucket_detail：获取特定桶的详细信息。
3. get_table_detail：获取特定表的详细信息。
4. retrieve_bucket_tables：检索特定桶中的所有表。
5. retrieve_buckets：检索项目中的所有桶。
6. update_bucket_description：更新桶的描述。
7. update_table_description：更新表的描述。
8. SQL 工具：
9. get_sql_dialect：获取 SQL 方言名称。
10. query_table：执行 SQL SELECT 查询。
11. 组件工具：
12. create_sql_transformation：创建 SQL 转换。
13. get_component_details：获取组件配置的详细信息。
14. retrieve_components：检索项目中的组件配置。
15. retrieve_transformations：检索项目中的转换配置。
16. 作业工具：
17. get_job_detail：获取作业的详细信息。
18. retrieve_jobs：检索项目中的所有作业。
19. start_job：启动新作业。
20. 文档工具：
21. docs_query：使用 Keboola 文档回答问题。

常见问题解答

1. 连接问题：检查日志、验证 API 令牌、确认路径是否正确。
2. BigQuery 支持：需要设置 GOOGLE_APPLICATION_CREDENTIALS 环境变量。
3. Python 版本问题：确保使用 Python 3.10 或更新版本。

使用教程

使用依赖

1. Python 3.10 或更新版本。
2. Keboola Storage API 令牌。
3. Snowflake 或 BigQuery 只读工作区。

安装教程

通过 Pip 安装

python3 -m venv --upgrade-deps .venv
source .venv/bin/activate
pip3 install keboola_mcp_server

通过 Smithery 安装

npx -y @smithery/cli install keboola-mcp-server --client claude

调试方式

1. 检查 Claude Desktop 日志。
2. 验证 API 令牌和路径。
3. 确认虚拟环境已正确激活。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。