MCP Kql Server

🚀 MCP KQL サーバー

このサーバーは、Microsoft Cloud Platform (MCP) をベースに構築されており、Azure CLI を通じた認証を利用して、Azure データエクスプローラーに対する KQL クエリを実行することができます。

🚀 クイックスタート

📦 インストール

1. uv がインストールされていることを確認します：

   pip install uv
   

2. 仮想環境を作成し、依存関係をインストールします：

   uvx venv
   source .venv/bin/activate  # Windows の場合は：.venv\Scripts\activate
   uvx pip install .
   

サーバーの起動

以下のコマンドを使用してサーバーを起動します：

uvx run start

サーバーは http://0.0.0.0:5000 で利用可能になります。

💻 使用例

基本的な使用法

• 認証：

  curl -X POST http://localhost:5000/auth
  

• KQL クエリの実行：

  curl -X POST http://localhost:5000/execute \
       -H "Content-Type: application/json" \
       -d '{"query": "cluster('\''mycluster'\'').database('\''mydb'\'').MyTable | take 10"}'
  

高度な使用法

Claude Desktop への統合

claude_desktop_config.json でサーバーを設定することで、Claude Desktop の kql_execute ツールを有効にすることができます。ツールの詳細については mcp_config.yaml を参照してください。

🔧 技術詳細

要件

• Python 3.9
• 認証に必要な Azure CLI (az)
• 依存関係：Flask、waitress、azure-kusto-data、tenacity

トラブルシューティング

• Azure CLI が認証されていることを確認します：az login
• サーバーのログを確認してエラーをチェックします。
• ポート 5000 が開かれており、アクセス可能であることを検証します。