Yunqiqiliang MCP Clickzetta Server

🚀 點擊即獲取數據 - Clickzetta 數據源對接指南

點擊即獲取數據（Clickzetta）是一個提供多種數據分析服務的平臺。下文將詳細介紹如何在 Claude Desktop 中集成 Clickzetta 數據源，實現數據分析與可視化。

🚀 快速開始

本指南將引導你完成 Clickzetta 數據源與 Claude Desktop 的對接，讓你能夠輕鬆進行數據分析與可視化操作。

✨ 主要特性

• 提供多種數據分析服務。
• 支持在 Claude Desktop 中集成數據源，實現數據的查詢與分析。
• 具備多種安全措施，保障數據安全。

📦 安裝指南

使用 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"
         ]
       }
     }
     

   • 保存配置後，服務器即可生效。

使用 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"
    ]
  }
}

💻 使用示例

基礎用法

在 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 注入攻擊。
• 日誌記錄：提供可選的日誌目錄和日誌級別配置。

📚 詳細文檔

圖片與表格說明

• 示例截圖：
  • 配置界面截圖：
  • 查詢結果展示：
• 對比表格： | 屬性 | 詳情 | |------|------| | 安全級別 | A級（高安全） | | 支持協議 | HTTP/HTTPS | | 最大連接數 | 無限制 |

總結

通過以上步驟，你可以輕鬆將 Clickzetta 數據源接入 Claude Desktop，實現高效的數據分析與可視化。如有任何問題，請隨時查閱官方文檔或聯繫技術支持團隊。