MCP Kql Server

🚀 MCP KQL Server

このサーバーは、Microsoft Cloud Platform (MCP) を利用し、Azure CLI 認証を通じて Azure Data Explorer に対して 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 が開いてアクセス可能であることを確認します。