Keboola Explorer MCP Server

基本能力

产品定位

Keboola Explorer MCP Server 是一个用于探索和管理 Keboola Connection 项目的 Claude MCP 服务器。

核心功能

• 存储桶管理：列出所有存储桶及其基本信息，获取特定存储桶的详细信息。
• 表格管理：列出特定存储桶中的所有表格，获取特定表格的详细信息，预览表格数据（默认最多 100 行）。
• 组件管理：列出特定组件的所有配置。

适用场景

• 需要浏览和管理 Keboola Connection 项目中的存储桶、表格和组件。
• 需要快速预览表格数据或获取特定组件的配置信息。

工具列表

• list_all_buckets: 列出项目中的所有存储桶及其基本信息。
• get_bucket_info: 获取特定存储桶的详细信息。
• list_bucket_tables_tool: 列出特定存储桶中的所有表格。
• get_table_info: 获取特定表格的详细信息。
• get_table_preview: 预览特定表格的数据（默认最多 100 行）。
• list_component_configs: 列出特定组件的所有配置。

常见问题解答

1. 没有出现锤子图标：
2. 检查配置文件是否在正确的位置。
3. 确保配置中的所有路径都是绝对路径。
4. 确保 uv 使用了完整路径。

5. 完全重启 Claude Desktop。

6. 连接错误：

7. 检查 Claude 的日志文件。
8. 验证 Keboola 令牌是否有效。

9. 确保所有依赖项已安装。

10. 服务器启动问题：

11. 直接测试服务器：KEBOOLA_STORAGE_TOKEN=your-token-here mcp dev server.py。

使用教程

使用依赖

• 安装并更新最新版本的 Claude Desktop。
• Python 3.10 或更高版本。
• Keboola 存储 API 令牌。

安装教程

1. 安装 uv 包管理器：

# 在 macOS/Linux 上
curl -LsSf https://astral.sh/uv/install.sh | sh

# 在 Windows 上
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

1. 克隆仓库并设置环境：

# 克隆仓库
git clone https://github.com/jordanrburger/keboola-mcp-server.git
cd keboola-mcp-server

# 创建虚拟环境
uv venv

# 激活虚拟环境
# 在 macOS/Linux 上：
source .venv/bin/activate
# 在 Windows 上：
.venv\Scripts\activate

# 安装依赖项
uv add "mcp[cli]" httpx pandas

调试方式

1. 启动服务器后，检查 Claude 输入框右下角的锤子图标，确认服务器已成功连接。
2. 查看实时日志：

# 在 macOS/Linux 上
tail -n 50 -f ~/Library/Logs/Claude/mcp*.log

# 在 Windows 上
type "%APPDATA%\Claude\logs\mcp*.log"

许可证

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