MCP Clickzetta Server

🚀 Clickzetta 為 Claude 桌面端服務器安裝指南

本指南將詳細介紹如何為 Claude 桌面端安裝 Clickzetta 服務器，提供了多種安裝方式及相關配置說明，同時介紹了其功能特性、示例查詢、安全注意事項和常見問題解答。

🚀 快速開始

你可以選擇不同的方式安裝 Clickzetta 服務器，以下為你詳細介紹各種安裝方法。

📦 安裝指南

安裝方式概述

1. 使用 Smithery 自動化安裝（此方法待測試驗證）

可通過 Smithery 自動安裝 Clickzetta Server，執行以下命令：

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

2. 使用 UVX 手動安裝（此方法待測試驗證）

在 claude_desktop_config.json 中添加服務器，將以下內容添加到該文件：

# 將以下內容添加到您的 claude_desktop_config.json 文件中
"mcpServers": {
  "clickzetta_pip": {
      "command": "uvx",
      "args": [
          "mcp_clickzetta_server",
          "--service",
          "the_service", # 替換為實際服務名
          "--instance",
          "the_instance", # 替換為實際實例名
          "--vcluster",
          "the_vcluster", # 替換為實際 vcluster 名
          "--workspace",
          "the_workspace", # 替換為實際工作區
           "--schema",
          "the_schema", # 替換為實際模式名
          "--user",
          "the_user", # 替換為實際用戶名
          "--password",
          "their_password" # 替換為實際密碼
          # 可選參數：
          # --allow_write (不推薦使用)
          # --log_dir, "/absolute/path/to/logs"
          # --log_level, "DEBUG"/"INFO"/"WARNING"/"ERROR"/"CRITICAL"
          # --exclude_tools, "{tool name}", ["{其他工具名}"]
      ]
  }
}

使用 UV 命令行工具安裝

在終端中執行以下命令：

uv --directory /Users/your_username/Documents/GitHub/mcp-clickzetta-server run mcp_clickzetta_server

配置說明

1. 打開 Claude 桌面端，進入設置 → MCP 服務器。
2. 添加一個新的服務器配置：

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

3. 保存配置。

使用環境變量配置

將以下內容添加到您的 .env 文件中：

# 示例 .env 配置文件
SERVICE_NAME=your_service_name
INSTANCE_NAME=your_instance_name
VCENTER_NAME=your_vcenter_name
WORKSPACE_NAME=your_workspace_name
SCHEMA_NAME=your_schema_name
DB_USER=your_database_user
DB_PASSWORD=your_database_password

✨ 主要特性

• 只讀操作：僅允許執行 SELECT 語句。
• 結果集限制：自動添加 LIMIT 子句以防止大數據量返回。
• 服務賬戶認證：通過服務賬戶進行安全連接。
• 輸入驗證：防止 SQL 注入攻擊。

💻 使用示例

基礎用法

查詢基本配置

clickzetta-mcp-server --schema your_schema --user your_user --password your_password

示例輸出

{
  "status": "success",
  "result": {
    "data": [
      {
        "column1": "value1",
        "column2": "value2"
      }
    ],
    "rowCount": 10,
    "columns": ["column1", "column2"]
  }
}

⚠️ 安全注意事項

• 配置文件保護：確保 .env 文件安全，避免洩露數據庫憑據。
• 網絡訪問控制：限制服務器的網絡訪問範圍。

❓ 常見問題

1. 無法連接到數據庫？
   • 檢查數據庫服務是否可用。
   • 確認憑據信息正確無誤。
2. 返回結果為空？
   • 檢查查詢語法是否正確。
   • 確保有足夠的權限執行查詢。