Keboola MCP 服务器

用于与 Keboola Connection 交互的模型上下文协议 (MCP) 服务器。该服务器提供用于列出和访问 Keboola Storage API 数据的工具。

要求

• Python 3.10 或更高版本
• Keboola 存储 API 令牌
• Snowflake 或 BigQuery 只读工作区

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Keboola Explorer：

手动安装

首先，克隆存储库并创建虚拟环境：

以开发模式安装包：

对于开发依赖项：

Claude 桌面设置

要将此服务器与 Claude Desktop 一起使用，请按照以下步骤操作：

1. 创建或编辑 Claude Desktop 配置文件：
   • macOS ： ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows ： %APPDATA%\Claude\claude_desktop_config.json
2. 添加以下配置（根据您的设置调整路径）：

代替：

• /path/to/keboola-mcp-server替换为您克隆的存储库的实际路径
• YOUR_REGION为你的 Keboola 区域（例如north-europe.azure等）。如果你的区域只是明确指定connection ，则可以将其移除。
• your-keboola-storage-token与您的 Keboola Storage API 令牌
• your-workspace-schema与您的工作区的 Snowflake 架构或 BigQuery 数据集

注意：如果您使用的是特定版本的 Python（例如由于某些软件包兼容性问题而使用 3.11），则需要将command更新为使用该特定版本，例如/path/to/keboola-mcp-server/.venv/bin/python3.11

注意：您可以在 Keboola 项目中创建工作区。它与您获取存储令牌的项目相同。工作区将提供所有必要的连接参数，包括架构或数据集名称。

3. 更新配置后：
   • 完全退出 Claude Desktop（不要只关闭窗口）
   • 重启Claude桌面
   • 找到右下角的锤子图标，表示服务器已连接

故障排除

如果遇到连接问题：

1. 检查 Claude Desktop 中的日志是否有任何错误消息
2. 验证您的 Keboola Storage API 令牌是否正确
3. 确保配置中的所有路径都是绝对路径
4. 确认虚拟环境已正确激活并且所有依赖项都已安装

光标 AI 设置

要将此服务器与 Cursor AI 一起使用，您有两种配置传输方法的选项：服务器发送事件 (SSE) 或标准 I/O (stdio)。

1. 创建或编辑 Cursor AI 配置文件：
   • 位置： ~/.cursor/mcp.json
2. 根据您的首选传输方式添加以下配置之一（或全部）：

选项 1：使用服务器发送事件 (SSE)

选项 2a：使用标准 I/O (stdio)

选项 2b：使用 WSL 标准 I/O (wsl stdio)

当使用 Cursor AI 从 Windows Subsystem for Linux 运行 MCP 服务器时，请使用此功能。

• 其中/wsl_path/to/keboola-mcp-server/.env文件包含环境变量：

代替：

• /path/to/keboola-mcp-server替换为您克隆的存储库的实际路径
• YOUR_REGION为你的 Keboola 区域（例如north-europe.azure等）。如果你的区域只是明确指定connection ，则可以将其移除。
• your-keboola-storage-token与您的 Keboola Storage API 令牌
• your-workspace-schema与您的工作区的 Snowflake 架构或 BigQuery 数据集

更新配置后：

1. 重启光标AI
2. 如果您使用sse传输，请确保启动您的 MCP 服务器。您可以在构建服务器的已激活虚拟环境中运行以下命令来启动它：
   /path/to/keboola-mcp-server/.venv/bin/python -m keboola_mcp_server --transport sse --api-url https://connection.YOUR_REGION.keboola.com
3. Cursor AI 应该会自动检测您的 MCP 服务器并启用它。

BigQuery 支持

如果您的 Keboola 项目使用 BigQuery 后端，则除了KBC_STORAGE_TOKEN和KBC_WORKSPACE_SCHEMA之外，您还需要设置GOOGLE_APPLICATION_CREDENTIALS环境变量。

1. 转到您的 Keboola BigQuery 工作区并显示其凭据（单击Connect按钮）。
2. 将凭证文件下载到本地磁盘。它是一个纯 JSON 文件。
3. 将下载的 JSON 凭证文件的完整路径设置为GOOGLE_APPLICATION_CREDENTIALS环境变量。

这将授予您的 MCP 服务器实例访问 Google Cloud 中的 BigQuery 工作区的权限。

可用工具

服务器提供以下工具与 Keboola Connection 交互：

• 列出存储桶和表
• 获取 bucket 和 table 信息
• 预览表数据
• 将表格数据导出为 CSV
• 列出组件和配置

发展

运行测试：

格式代码：

类型检查：

执照

MIT 许可证 - 详情请参阅 LICENSE 文件。