Microsoft Security Copilot

🚀 セキュリティCopilotとSentinel MCPサーバー

このプロジェクトは、PythonをベースとしたMCPサーバーで、FastMCPライブラリを使用してMicrosoftセキュリティCopilotとMicrosoft Sentinelとの統合を実現し、Azure Identityを通じて認証を行います。

🚀 クイックスタート

このサーバーは、開発環境とMicrosoftセキュリティCopilotの間の橋渡しとして機能し、技能やプラグインのテスト、デプロイ、実行をサポートします。SSEを伝送層とするMCPサーバーです。

✨ 主な機能

• Sentinel統合：Microsoft SentinelでKQLクエリを実行します。
• セキュリティCopilot管理：
  • 既存の技能セット/プラグインを一覧表示します。
  • 新しい技能をアップロードまたは既存の技能を更新します。
  • MicrosoftセキュリティCopilotでプロンプトまたは技能を実行します。
• 認証サポート：対話型ブラウザ、クライアントパスワード、マネージドIDを含む複数の認証方法をサポートします。

📚 ドキュメント

ロードマップ

次の機能には、以下が含まれます：

• Promptbookのテストと更新
• Defender XDRで高度なハンティングクエリを実行

前提条件

• Python 3.8+
• Microsoft Sentinelワークスペース
• MicrosoftセキュリティCopilotへのアクセス権
• Microsoft 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

利用可能なツール

MCPサーバーが提供するツールは以下の通りです：

1. run_sentinel_query：SentinelでKQLクエリを実行します。
2. get_skillsets：セキュリティCopilotの技能セットを一覧表示します。
3. upload_plugin：技能セット/プラグインをアップロードまたは更新します。
4. run_prompt：セキュリティCopilotでプロンプトまたは技能を実行します。

MCPクライアントの設定（Cursor用）

このMCPサーバーを任意のクライアントから操作することができます。このリポジトリには、Cursor用の説明と設定ファイルが含まれています。

クライアントプロジェクトに.cursorフォルダを追加して、MCPツールを有効にします。このフォルダには2つのファイルが含まれています：

1. Cursorプロジェクトルール（securitycopilotdev.mdc）：このファイルには、ユーザーのプロンプトを理解するためのカスタムCursorルールが含まれています。
2. MCPクライアント設定（mcp.json）：CursorをMCPサーバーに接続するためのファイルです。

/tool_nameコマンドでツールを実行できます。例えば：

/clean_code

設定ファイルで必要なパラメーターと資格情報を指定して、ツールが正常に動作するようにします。

コントリビューションガイド

このプロジェクトに貢献したい場合は、以下の手順に従ってください：

1. メインブランチから機能ブランチを作成します。
2. 変更をコミットし、プルリクエストを作成します。
3. 変更について議論し、フィードバックに基づいて調整します。
4. メインブランチにプッシュします。

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。具体的な内容は以下の通りです：

 MIT License

Copyright (c) [Year] [Author Name]

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.