Clickzetta MCP Server
2025.04.21
0
Python数据库交互数据分析数据管理数据库
Clickzetta MCP Server 是一个基于模型上下文协议（MCP）的服务器实现，主要用于与Clickzetta Lakehouse数据库进行交互。该服务器支持执行SQL查询、管理数据库表结构以及收集和分析数据洞察。它通过提供一系列工具和动态资源，使得用户能够方便地进行数据查询、表结构管理和数据分析。
View on GitHub
Overview
基本能力
产品定位
Clickzetta MCP Server 是一个数据库交互工具，旨在通过MCP协议提供对Clickzetta Lakehouse的高效访问和管理能力。
核心功能
- 数据库查询：支持SELECT、INSERT、UPDATE、DELETE等SQL查询操作。
- 表结构管理：支持创建表、列出所有表、描述表结构等功能。
- 数据分析：通过
append_insight工具收集和分析数据洞察，并动态更新memo://insights资源。
适用场景
- 数据查询与分析：执行复杂的SQL查询，获取数据分析结果。
- 数据库管理：管理数据库表结构，包括创建表和查看表结构。
- 数据洞察收集：通过自动化工具收集和更新数据洞察，便于后续分析。
工具列表
- read_query：执行SELECT查询，返回查询结果。
- write_query：执行INSERT、UPDATE、DELETE查询（需启用
--allow-write标志）。 - create_table：创建新表（需启用
--allow-write标志）。 - list_tables：列出数据库中的所有表。
- describe-table：查看特定表的列信息。
- append_insight：添加新的数据洞察到
memo://insights资源。
常见问题解答
- 安全性：默认情况下，服务器仅允许读操作（SELECT语句），并自动添加LIMIT子句以防止返回大量结果集。
- 安装问题：确保在安装前配置好
.env文件中的Clickzetta Lakehouse凭据。 - 调试：可以通过日志查看服务器运行状态和错误信息。
使用教程
使用依赖
- 确保已安装Python 3.12.2及以上版本。
- 安装
uv工具：bash pip install uv
安装教程
- 克隆仓库：
bash git clone https://github.com/yunqiqiliang/mcp-clickzetta-server.git cd mcp-clickzetta-server - 安装包：
bash uv pip install -e . -i https://pypi.tuna.tsinghua.edu.cn/simple/ - 配置凭据：创建
.env文件并填写Clickzetta Lakehouse凭据。
调试方式
- 启动服务器：
bash uv run mcp_clickzetta_server - 查看日志：服务器启动后会输出日志信息，包括允许的工具列表和运行状态。
- 集成到Claude Desktop：在Claude Desktop的MCP Servers设置中添加服务器路径和参数。