Keboola MCP Server

Keboola MCP Server

site icon
2025.04.17 10
Python数据管理Keboola 集成数据库开发效率
Keboola MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器,用于与 Keboola Connection 交互。该服务器提供了访问 Keboola Storage API 数据的工具,支持列出和访问数据。主要功能包括列出存储桶和表、获取表和存储桶信息、预览表数据、导出表数据到 CSV 以及列出组件和配置。适用于需要与 Keboola Connection 进行数据交互的开发者和数据分析师。
View on GitHub

Overview

基本能力

产品定位

Keboola MCP Server 是一个用于与 Keboola Connection 交互的 MCP 服务器,提供数据访问和管理工具。

核心功能

  • 列出存储桶和表
  • 获取存储桶和表信息
  • 预览表数据
  • 导出表数据到 CSV
  • 列出组件和配置

适用场景

  • 需要与 Keboola Connection 进行数据交互的开发
  • 数据分析师需要快速访问和预览数据
  • 数据导出和转换任务

工具列表

  • List buckets and tables: 列出可用的存储桶和表
  • Get bucket and table information: 获取存储桶和表的详细信息
  • Preview table data: 预览表数据内容
  • Export table data to CSV: 将表数据导出为 CSV 文件
  • List components and configurations: 列出组件及其配置

常见问题解答

  1. 连接问题:检查 Keboola Storage API token 是否正确,确保路径是绝对路径。
  2. 虚拟环境问题:确认虚拟环境已正确激活且所有依赖已安装。
  3. 区域设置:确保 YOUR_REGION 设置正确,或直接使用 connection

使用教程

使用依赖

  • Python 3.10 或更新版本
  • Keboola Storage API token
  • Snowflake Read Only Workspace

安装教程

通过 Smithery 安装

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

手动安装

git clone https://github.com/keboola/keboola-mcp-server.git
cd keboola-mcp-server
python3 -m venv .venv
source .venv/bin/activate
pip3 install -U pip
pip3 install -e .

调试方式

  1. 检查 Claude Desktop 日志中的错误信息。
  2. 验证 Keboola Storage API token 是否正确。
  3. 确保所有路径是绝对路径。
  4. 确认虚拟环境已激活且依赖已安装。

开发

运行测试

pytest

代码格式化

black .
isort .

类型检查

mypy .

许可证

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