Azure MCP Server tools for Azure Data Explorer

Azure MCP 伺服器允許您使用自然語言提示來管理 Azure Data Explorer 資源。 你可以用自然語言列出叢集、查看資料庫並查詢資料。 您也可以使用特定的 KQL 查詢來取得目標回應。

Azure 資料總 管是快速且完全受控的數據分析服務,可即時分析來自應用程式、網站、IoT 裝置等大量數據串流。 Azure 資料總管可協助您分析來自任何數據源的大量不同數據,例如網站、應用程式、IoT 裝置等等。

備註

工具參數:Azure MCP 伺服器工具會定義完成工作所需資料的參數。 這些參數中有些是針對每種工具而定,並在此處有詳細說明。 其他參數是全局參數,並由所有工具共用。 如需詳細資訊,請參閱 工具參數。

條件式參數

某些 Azure 資料總管工具需要交談內容中的下列 其中一個 參數集:

  • 選項 1:叢集 URI
  • 選項 2:叢集名稱和訂閱服務

當你提供叢集名稱時,可從你設定的 Azure 內容中解析出訂閱。 如果你提供叢集 URI,工具會使用該 URI;此時不需要叢集名稱和訂閱。 這些資料平面工具不需要資源群組。

叢集:列出叢集

範例 CLI 指令

azmcp kusto cluster list \
  [--resource-group <resource-group>]
參數 類型 為必填項目 說明
resource-group 字串 No 將叢集限制在這個資源群。 省略此項,以列出跨訂用帳戶的叢集。

工具註解提示:

破壞性 冪等 開放世界 唯讀 Secret 本地必修
❌ ✅ ❌ ✅ ❌ ❌

叢集:取得叢集詳細資料

範例 CLI 指令

azmcp kusto cluster get \
  --cluster <cluster>
參數 類型 為必填項目 說明
cluster 字串 Yes Azure 數據總管叢集的名稱。

工具註解提示:

破壞性 冪等 開放世界 唯讀 Secret 本地必修
❌ ✅ ❌ ✅ ❌ ❌

資料庫:列出所有資料庫

範例 CLI 指令

azmcp kusto database list \
  [--cluster-uri <cluster-uri>] \
  [--cluster <cluster>]
參數 類型 為必填項目 說明
cluster-uri 字串 No Azure 數據總管叢集的 URI。
cluster 字串 No Azure 數據總管叢集的名稱。

工具註解提示:

破壞性 冪等 開放世界 唯讀 Secret 本地必修
❌ ✅ ❌ ✅ ❌ ❌

表格:清單表格

範例 CLI 指令

azmcp kusto table list \
  --database <database> \
  [--cluster-uri <cluster-uri>] \
  [--cluster <cluster>]
參數 類型 為必填項目 說明
database 字串 Yes Azure 數據總管資料庫的名稱。
cluster-uri 字串 No Azure 數據總管叢集的 URI。
cluster 字串 No Azure 數據總管叢集的名稱。

工具註解提示:

破壞性 冪等 開放世界 唯讀 Secret 本地必修
❌ ✅ ❌ ✅ ❌ ❌

表格:取得表格結構描述

範例 CLI 指令

azmcp kusto table schema \
  --table <table> \
  --database <database> \
  [--cluster-uri <cluster-uri>] \
  [--cluster <cluster>]
參數 類型 為必填項目 說明
table 字串 Yes Azure Data Explorer 資料表的名稱。
database 字串 Yes Azure 數據總管資料庫的名稱。
cluster-uri 字串 No Azure 數據總管叢集的 URI。
cluster 字串 No Azure 數據總管叢集的名稱。

工具註解提示:

破壞性 冪等 開放世界 唯讀 Secret 本地必修
❌ ✅ ❌ ✅ ❌ ❌

範例數據

範例 CLI 指令

azmcp kusto sample \
  --table <table> \
  --database <database> \
  [--limit <limit>] \
  [--cluster-uri <cluster-uri>] \
  [--cluster <cluster>]
參數 類型 為必填項目 說明
table 字串 Yes Azure Data Explorer 資料表的名稱。
database 字串 Yes Azure 數據總管資料庫的名稱。
limit 字串 No 要傳回的結果數目上限。 必須是介於1到10000之間的正整數。 預設值為 10。
cluster-uri 字串 No Azure 數據總管叢集的 URI。
cluster 字串 No Azure 數據總管叢集的名稱。

工具註解提示:

破壞性 冪等 開放世界 唯讀 Secret 本地必修
❌ ✅ ❌ ✅ ❌ ❌

Query

範例 CLI 指令

azmcp kusto query \
  --query <query> \
  --database <database> \
  [--cluster-uri <cluster-uri>] \
  [--cluster <cluster>]
參數 類型 為必填項目 說明
query 字串 Yes 要執行的 Kusto 查詢語言(KQL)查詢。
database 字串 Yes Azure 數據總管資料庫的名稱。
cluster-uri 字串 No Azure 數據總管叢集的 URI。
cluster 字串 No Azure 數據總管叢集的名稱。

工具註解提示:

破壞性 冪等 開放世界 唯讀 Secret 本地必修
❌ ✅ ❌ ✅ ❌ ❌