Microsoft Sentinel

🚀 微軟Sentinel MCP服務器指南

本指南詳細介紹了微軟Sentinel MCP服務器的安裝、配置、開發、認證等方面的內容，幫助您快速上手並使用該服務器。

🚀 快速開始

在Claude Desktop或其他MCP兼容客戶端中安裝

使用提供的PowerShell安裝腳本來設置MCP服務器以適用於Claude Desktop或類似環境：

# 從存儲庫根目錄運行
.\install.ps1

該腳本將執行以下操作：

1. 檢查Python的安裝情況
2. 創建虛擬環境並安裝依賴項
3. 執行安裝後配置步驟
4. 生成適用於Claude Desktop的配置文件
5. 將配置複製到剪貼板

運行腳本後，可以直接將配置粘貼到您的MCP客戶端（如Claude Desktop、Cursor等）中。該腳本會為Claude兼容的MCP服務器生成配置。

📦 安裝指南

高級安裝選項

手動環境設置

如果您更傾向於手動設置環境：

1. 配置環境變量 複製提供的模板並填寫您的Azure憑證：

cp .env.example .env
# 編輯.env文件並設置：
# AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_SUBSCRIPTION_ID, AZURE_RESOURCE_GROUP, AZURE_WORKSPACE_NAME, AZURE_WORKSPACE_ID

2. 安裝依賴項（使用uv）

uv venv
uv pip install -e .

3. 替代服務器運行選項
   • 使用MCP CLI：

mcp run wrapper.py

- **開發與熱重載**：

mcp dev wrapper.py

- **SSE模式（針對IDE）**：

python wrapper.py --sse

檢查工具UI

當使用mcp dev wrapper.py運行時，MCP檢查工具UI將在http://127.0.0.1:6274可用。

📚 詳細文檔

開發指南

• 資源：將Python文件添加到resources/目錄，並實現一個register_resources(mcp)函數。
• 工具：將Python文件添加到tools/目錄，並實現一個register_tools(mcp)函數。工具必須遵循在docs/tool-architecture-and-implementation-requirements.md中定義的結構。
• 提示：將提示模板添加到prompts/目錄，用於LLM驅動的工作流程。

所有位於resources/、tools/和prompts/目錄中的組件將在服務器啟動時自動發現並註冊。無需手動導入。

認證與環境變量

MCP Server支持由Azure Python SDK的DefaultAzureCredential支持的任何認證方法。

使用服務主體身份驗證而非Azure CLI

在Azure中設置一個應用程序註冊，並授予以下角色：

• Log Analytics Reader
• Microsoft Sentinel Reader

如果您願意，也可以授予應用程序註冊以下Microsoft Graph權限：

• User.Read.All
• Group.Read.All

然後，在您的.env文件或MCP Server配置中使用以下環境變量：

• AZURE_TENANT_ID
• AZURE_CLIENT_ID
• AZURE_CLIENT_SECRET
• AZURE_SUBSCRIPTION_ID
• AZURE_RESOURCE_GROUP
• AZURE_WORKSPACE_NAME
• AZURE_WORKSPACE_ID

查看.env.example獲取模板。

使用Azure CLI身份驗證

az login

如果您使用Azure CLI身份驗證，則可以從您的配置中省略AZURE_CLIENT_SECRET和AZURE_CLIENT_SECRET。

錯誤排除與支持

如果在安裝或配置過程中遇到問題，請參考項目文檔或聯繫支持團隊。您也可以通過社區論壇或其他資源尋求幫助。

以上是Microsoft Sentinel MCP Server的完整指南，涵蓋了從安裝到開發的所有內容。