点击即获取数据 - Clickzetta 数据源对接指南

安装说明

使用 UV 搭建 Clickzetta MCP 服务器

全部内容概述

• 点击即获取数据（Clickzetta）是一个提供多种数据分析服务的平台。
• 下文将详细介绍如何在 Claude Desktop 中集成 Clickzetta 数据源，实现数据分析与可视化。

安装方法

使用 U 盘安装 Clickzetta MCP 服务器

具体步骤如下：

1. 复制代码库到本地：

   git clone https://github.com/yourusername/mcp-clickzetta-server.git
   cd mcp-clickzetta-server
   

2. 配置环境变量：

   • 创建并编辑 .env 文件，填写你的 Clickzetta 账号信息：

     SERVICE_NAME=the_service
     INSTANCE_ID=the_instance
     VCENTER_NAME=the_vcluster
     WORKSPACE_NAME=the_workspace
     SCHEMA_NAME=the_schema
     USER_NAME=the_user
     PASSWORD=the_password
     

3. 启动 MCP 服务：

   uv run mcp_clickzetta_server --directory ./mcp-clickzetta-server
   

4. 在 Claude Desktop 中配置服务器连接：

   • 打开 Claude 设置界面 → 点击 "MCP 服务器" 栏目。
   • 新增一个服务器配置，填写以下信息：

     {
       "clickzetta-mcp-server": {
         "command": "/Users/yourusername/anaconda3/bin/uv",
         "args": [
           "--directory",
           "/Users/yourusername/Documents/GitHub/mcp-clickzetta-server",
           "run",
           "mcp_clickzetta_server"
         ]
       }
     }
     

   • 保存配置后，服务器即可生效。

示例查询

在 Claude Desktop 中可以执行以下类型的问题：

• 简单查询：

  • "列出我 Clickzetta 账号下的所有数据库。"
  • "展示 PUBLIC 数据库中的表结构。"

• 复杂分析：

  • "帮我从 Clickzetta 中读取数据，分析下在 public 这个模式下 github_users 表里每个公司的用户数。请用中文返回结果，并对结果进行数据可视化展现。"

• SQL 执行：

  SELECT customer_id, SUM(order_total) as total_spend FROM SALES.ORDERS GROUP BY customer_id ORDER BY total_spend DESC LIMIT 10;
  

安全注意事项

本服务器实现以下安全措施：

• 只允许读取操作：默认仅支持 SELECT 语句。
• 结果集限制：自动添加 LIMIT 子句防止大数据量返回。
• 身份验证：使用服务账户进行连接认证。
• 输入校验：防范 SQL 注入攻击。
• 日志记录：提供可选的日志目录和日志级别配置。

其他安装方式

使用 Smithery 自动化安装

npx -y @smithery/cli@latest install @yunqiqiliang/mcp-clickzetta-server --client claude --key ******

使用 UVX 配置

在 claude_desktop_config.json 中添加服务器配置：

"mcpServers": {
  "clickzetta_pip": {
    "command": "/Users/yourusername/.uv/bin/uv",
    "args": [
      "run",
      "--directory",
      "/Users/yourusername/Documents/GitHub/mcp-clickzetta-server",
      "mcp_clickzetta_server"
    ]
  }
}

图片与表格说明

• 示例截图：

  • 配置界面截图：
  • 查询结果展示：

• 对比表格： | 特性 | 描述 | |---------------|----------------------------------------| | 安全级别 | A级（高安全） | | 支持协议 | HTTP/HTTPS | | 最大连接数 | 无限制 |

总结

通过以上步骤，你可以轻松将 Clickzetta 数据源接入 Claude Desktop，实现高效的数据分析与可视化。如有任何问题，请随时查阅官方文档或联系技术支持团队。