基本能力
产品定位
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: 列出组件及其配置
常见问题解答
- 连接问题：检查 Keboola Storage API token 是否正确，确保路径是绝对路径。
- 虚拟环境问题：确认虚拟环境已正确激活且所有依赖已安装。
- 区域设置：确保
YOUR_REGION设置正确，或直接使用connection。
使用教程
使用依赖
- Python 3.10 或更新版本
- Keboola Storage API token
- Snowflake Read Only Workspace
安装教程
通过 Smithery 安装
bash
npx -y @smithery/cli install keboola-mcp-server --client claude
手动安装
bash
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 .
调试方式
- 检查 Claude Desktop 日志中的错误信息。
- 验证 Keboola Storage API token 是否正确。
- 确保所有路径是绝对路径。
- 确认虚拟环境已激活且依赖已安装。
开发
运行测试
bash
pytest
代码格式化
bash
black .
isort .
类型检查
bash
mypy .
