Clickzetta 为 Claude 桌面端服务器安装指南

安装方式概述

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. 返回结果为空？

   • 检查查询语法是否正确。
   • 确保有足够的权限执行查询。