Microsoft Security Copilot

🚀 安全Copilot和Sentinel MCP服務器

這是一個基於Python的MCP服務器，藉助FastMCP庫實現了與微軟安全Copilot和微軟Sentinel的集成，並通過Azure Identity進行身份驗證。它就像一座橋樑，連接著開發環境與微軟安全Copilot，支持技能和插件的測試、部署與執行。

🚀 快速開始

先決條件

• Python 3.8+
• 微軟Sentinel工作區
• 微軟安全Copilot訪問權限
• 對微軟Sentinel和安全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=你的租戶ID
   # AZURE_CLIENT_ID=你的客戶端ID
   # AZURE_CLIENT_SECRET=你的客戶端密碼
   SENTINEL_SUBSCRIPTION_ID=你的訂閱ID
   SENTINEL_RESOURCE_GROUP=你的資源組
   SENTINEL_WORKSPACE_NAME=你的工作區名稱
   SENTINEL_WORKSPACE_ID=你的工作區ID
   # 身份驗證選項：interactive、client_secret
   AUTHENTICATION_TYPE=interactive
   

啟動服務器

運行MCP服務器：

python server.py

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

python server.py --run-tests

✨ 主要特性

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

💻 使用示例

可用工具

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

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

MCP客戶端配置（適用於Cursor）

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

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

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

你可以通過/tool_name命令運行工具。例如：

/clean_code

在配置文件中指定所需的參數和憑據，以便工具能夠正常工作。

📚 詳細文檔

概述

該項目實現了以下功能的MCP服務器：

• 在微軟Sentinel中執行KQL查詢
• 上傳/更新微軟安全Copilot技能集/插件
• 在微軟安全Copilot中運行提示詞或技能

該服務器充當開發環境與微軟安全Copilot之間的橋樑，支持技能和插件的測試、部署和執行。它使用SSE作為傳輸層的MCP服務器。

當前集成有多種用途，其中最有趣的是支持安全Copilot KQL技能的開發、測試和部署。

路線圖

接下來的功能將包括：

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

貢獻指南

如果你希望為項目做出貢獻，請按照以下步驟操作：

1. 從主分支創建功能分支。
2. 提交你的更改並創建拉取請求。
3. 討論你的更改，並根據反饋進行調整。
4. 推送到主分支。

📄 許可證

本項目使用MIT許可證，具體內容如下：

 MIT License

版權所有 (c) [年份] [作者姓名]

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.