Securitycopilotmcpserver

🚀 安全 Copilot 和 Sentinel MCP 服務器

這是一個基於 Python 的 MCP 服務器，藉助 FastMCP 庫實現了與 Microsoft Security Copilot 和 Microsoft Sentinel 的集成，並且支持通過 Azure Identity 進行身份驗證。它為開發環境與 Microsoft Security Copilot 搭建了橋樑，可用於測試、部署和執行技能與插件。

🚀 快速開始

先決條件

• Python 3.8+
• Microsoft Sentinel 工作區
• Microsoft Security Copilot 訪問權限
• 對 Sentinel 和 Security Copilot 的適當 Azure 權限

安裝

1. 克隆倉庫：

   git clone https://github.com/jguimera/SecurityCopilotMCPServer.git
   cd SecurityCopilotMCPServer
   

2. 安裝依賴項：

   pip install -r requirements.txt
   

3. 創建 .env 文件，配置如下：

   # 添加應用註冊以使用客戶端 ID 和密鑰進行身份驗證
   # AZURE_TENANT_ID=your_tenant_id
   # AZURE_CLIENT_ID=your_client_id
   # AZURE_CLIENT_SECRET=your_client_secret
   SENTINEL_SUBSCRIPTION_ID=your_subscription_id
   SENTINEL_RESOURCE_GROUP=your_resource_group
   SENTINEL_WORKSPACE_NAME=your_workspace_name
   SENTINEL_WORKSPACE_ID=your_workspace_id
   # 身份驗證選項：interactive、client_secret
   AUTHENTICATION_TYPE=interactive
   

啟動服務器

運行 MCP 服務器：

python server.py

在啟動服務器前運行測試：

python server.py --run-tests

✨ 主要特性

• Sentinel 集成：可在 Sentinel 工作區執行 KQL 查詢。
• Security Copilot 管理：
  • 列出現有的技能集/插件。
  • 上傳新的或更新現有技能集/插件。
  • 執行安全 Copilot 中的提示或技能。
• 身份驗證支持：支持多種身份驗證方法，包括交互式瀏覽器、客戶機密鑰和託管標識。

📚 詳細文檔

可用工具

MCP 服務器提供的工具包括：

1. run_sentinel_query：在 Sentinel 中執行 KQL 查詢。
2. get_skillsets：列出安全 Copilot 中的技能集。
3. upload_plugin：上傳或更新一個技能集/插件。
4. run_prompt：在安全 Copilot 中運行提示或技能。

Cursor 的 MCP 客戶端配置

你可以從你選擇的客戶端使用此 MCP 服務器。在此倉庫中，你會發現用於 Cursor 的說明和配置文件。

在你的客戶端項目中添加 .cursor 文件夾以啟用 MCP 工具。該文件夾包含兩個文件：

1. Cursor 項目規則（securitycopilotdev.mdc）：此文件包括一些自定義的 Cursor 規則，幫助代理理解用戶提示的過程。
2. MCP 客戶端配置（mcp.json）：連接到 MCP 服務器的文件。

你可以使用 /tool_name 參數1="Value of the tool parameter" 直接調用工具。例如：/run_prompt content="列出最近風險較高的用戶"

更多詳細信息請參考：https://docs.cursor.com/context/model-context-protocol#配置-MCP-服務器

🔮 路線圖

接下來的功能將包括：

• Promptbook 測試和更新
• 在 Defender XDR 中運行高級狩獵查詢

🤝 貢獻

歡迎貢獻！請隨意提交 Pull Request。

📄 許可證

該項目受 LICENSE 許可保護。