Kusto MCP

🚀 自然言語からKustoクエリへのMCPサーバー

自然言語をKustoクエリに変換し、それらのクエリをKustoで実行できる、設定可能なMCPサーバーです。

✨ 主な機能

• 設定：YAMLファイルを使用して設定できます。
• クエリ生成：プロンプトに基づいてKustoクエリを生成します。
• クエリ実行：生成されたKustoクエリを実行します。
• 複数データベース対応：複数のKustoデータベースをサポートしています。

📦 ツールリスト

1. 設定ツール

• 用途：YAMLファイルを使用して設定を行います。
• 入力パラメータ：
  • endpoint：Kustoクラスターのエンドポイントを指定します。
  • appid と appkey：認証に使用する資格情報です。

2. クエリ生成ツール

• 用途：プロンプトに基づいてKustoクエリを生成します。
• 入力パラメータ：
  • prompt：ユーザーが提供するプロンプト情報です。
  • context（オプション）：JSON形式で提供されるコンテキスト情報です。
  • options（オプション）：同じくJSON形式で提供されるオプション情報です。

3. クエリ実行ツール

• 用途：Kustoクエリを実行し、結果を返します。
• 入力パラメータ：
  • query：実行するクエリ文です。
  • context（オプション）：JSON形式で提供されるコンテキスト情報です。
  • options（オプション）：同じくJSON形式で提供されるオプション情報です。

4. 複数データベース対応ツール

• 用途：複数のKustoデータベース間で切り替えることをサポートします。
• 入力パラメータ：
  • database：操作対象のデータベース名を指定します。

📚 ドキュメント

環境変数の参照

設定ファイルでは、以下の環境変数を参照できます。

{
  "endpoint": "your-kusto-endpoint",
  "appid": "${env:AZURE_CLIENT_ID}",
  "appkey": "${env:AZURE_CLIENT_SECRET}"
}

モデル設定の例

{
  "model": {
    "type": "openai",
    "config": {
      "temperature": 0.7,
      "max_tokens": 1000,
      "api_key": "${env:AZURE_OPENAI_KEY}"
    }
  },
  "kusto": {
    "clusters": {
      "your-cluster-name": {
        "endpoint": "https://your-kusto-endpoint",
        "appid": "${env:AZURE_CLIENT_ID}",
        "appkey": "${env:AZURE_CLIENT_SECRET}"
      }
    }
  }
}

Kusto設定の例

clusters:
  your-cluster-name:
    endpoint: https://your-kusto-endpoint
    auth:
      appid: your-app-id
      appkey: your-app-key

注意事項

⚠️ 重要提示

• すべての endpoint URLが正しく、アクセス可能であることを確認してください。
• prompts 部分を更新して、関連するクエリと説明を含めてください。内容は詳細なほど良いです。
• 提供された設定例をテンプレートとして使用して、独自の settings.yaml ファイルを作成してください。

VS Codeでの使用方法

.vscode/mcp.json に以下の内容を追加します。

{
  "inputs": [
    {
        "type": "promptString",
        "id": "azure-open-ai-key",
        "description": "请输入您的Azure OpenAI密钥",
        "password": true
    },
    {
        "type": "promptString",
        "id": "kusto-token",
        "description": "请输入您的Kusto令牌",
        "password": true
    }
  ],
  "kusto": {
    "type": "stdio",
    "command": "docker",
    "args": [
        "run",
        "-i",
        "--rm",
        "-v",
        "/path/to/settings.yaml:/app/settings.yaml", // settings.yamlファイルのパスを入力します。VSCode変数を使用できます。
        // settings.yamlファイルで参照される環境変数を含めます。
        "-e",
        "AZURE_OPENAI_KEY",
        "-e",
        "KUSTO_ACCESS_TOKEN",
        "alexeyler/kusto-mcp-server",
    ],
    "env": {
        "AZURE_OPENAI_KEY": "${input:azure-open-ai-key}",
        "KUSTO_ACCESS_TOKEN": "${input:kusto-token}",
    }
  }
}

ビルド方法

プロジェクトのルートディレクトリから次のコマンドを実行します。

docker build ./src/Server/Dockerfile src