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. 返回结果为空？
   • 检查查询语法是否正确。
   • 确保有足够的权限执行查询。