MCP Clickzetta Server

🚀 Clickzetta をClaudeデスクトップ端末用サーバーにインストールするガイド

Clickzettaは、Claudeデスクトップ端末用のサーバーを提供するツールです。このガイドでは、Clickzettaサーバーをインストールする方法を説明します。

🚀 クイックスタート

このガイドでは、Clickzetta ServerをClaudeデスクトップ端末にインストールする方法を説明します。2種類のインストール方法を提供していますが、どちらも未検証ですので、注意して使用してください。

📦 インストール

インストール方法の概要

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. 結果が空です。
   • クエリ構文が正しいことを確認してください。
   • クエリを実行するのに十分な権限があることを確認してください。