ROADrecon MCP Server

ROADrecon MCP サーバー

この MCP（Model Context Protocol）サーバーを使うと、Claude などの AI アシスタントが ROADRecon の Azure AD データにアクセスし、セキュリティ分析を行えます。

dirkjanm による素晴らしい ROADtools スイートはこちらです：ROADRecon

機能

• リソース：ROADRecon インスタンスの Azure AD データにアクセスします
• ツール：データに対してセキュリティ分析を実行します
• プロンプト：一般的なセキュリティタスク向けの、事前に作成された分析テンプレートです

前提条件

• Python 3.8+
• Web GUI にアクセスできる、稼働中の ROADRecon インスタンス
• MCP 対応クライアント（Claude Desktop など）

インストール

1. このリポジトリをクローンします
2. 依存関係をインストールします：

   pip install -r requirements.txt
   

使用方法

サーバーの実行

1. ROADRecon GUI が実行中であることを確認します（デフォルト：http://localhost:5000）

2. MCP サーバーを実行します：

   python roadrecon_mcp_server.py
   

3. 別の ROADRecon URL を指定するには：

   ROADRECON_URL=http://localhost:8080 python roadrecon_mcp_server.py
   

Claude Desktop への接続

1. Claude Desktop を開きます
2. Settings → Servers → Add Server に移動します
3. 「Add from running server」を選択します
4. サーバーが一覧に表示されたら、「Install」をクリックします

この手順の詳細はこちらをご覧ください：https://modelcontextprotocol.io/quickstart/server

Claude での使用

接続すると、Claude は次のことができます：

• リソースを通じて Azure AD データにアクセスする（例：roadrecon://users）
• ツールを使ってセキュリティ分析を実行する（例：find_privileged_users）
• 一般的なセキュリティタスク向けの事前作成済みプロンプトを使う

クエリの例

• 「この Azure AD テナントのユーザーの MFA 状況を分析してください」
• 「特権ロールを持つユーザーをすべて見つけてください」
• 「シークレットまたは証明書を持つアプリケーションを確認してください」
• 「この Azure AD 環境全体のセキュリティ態勢を分析してください」

https://github.com/user-attachments/assets/806e9ccd-d80e-4058-be4f-9d37095f1fd6

利用可能なリソース

• roadrecon://stats - 概要統計
• roadrecon://users - すべてのユーザー
• roadrecon://users/{id} - ユーザーの詳細
• roadrecon://groups - すべてのグループ
• roadrecon://groups/{id} - グループの詳細
• roadrecon://applications - すべてのアプリケーション
• roadrecon://applications/{id} - アプリケーションの詳細
• roadrecon://serviceprincipals - すべてのサービスプリンシパル
• roadrecon://serviceprincipals/{id} - サービスプリンシパルの詳細
• roadrecon://devices - すべてのデバイス
• roadrecon://mfa - すべてのユーザーの MFA 状況
• roadrecon://directoryroles - すべてのディレクトリロール
• roadrecon://roledefinitions - すべてのロール定義
• roadrecon://approles - すべてのアプリロールの割り当て
• roadrecon://oauth2permissions - すべての OAuth2 権限付与
• roadrecon://tenantdetails - テナントの詳細

利用可能なツール

• find_privileged_users() - 高い特権を持つロールのユーザーを検索します
• analyze_mfa_status() - ユーザー全体の MFA 導入状況を分析します
• find_applications_with_secrets() - シークレットまたは証明書を持つアプリケーションを検索します
• analyze_groups() - グループの種類とメンバーシップを分析します
• identify_stale_accounts() - 指定した期間内にログインまたはパスワード変更を行っていないアカウントを検索します
• analyze_pim_implementation() - 特権 ID 管理（PIM）の導入状況を評価します
• analyze_service_principal_credentials() - 有効期間の長い認証情報を持つ、過剰な権限が付与されたサービスプリンシパルを検索します
• analyze_legacy_authentication() - MFA を回避するレガシー認証プロトコルによるリスクを特定します
• analyze_conditional_access_policies(file_path: str = "") - HTML ファイルから条件付きアクセス ポリシーを分析します。デフォルトでは "C:\Temp\caps.html" を探し、見つからない場合はユーザーにファイルパスの指定を求めます。

利用可能なプロンプト

• analyze_security_posture - 包括的なセキュリティ分析
• analyze_privileged_access - 特権アクセスモデルの分析
• investigate_application_risks - アプリケーションのセキュリティリスク評価
• analyze_identity_security - ID セキュリティ設定の分析
• analyze_stale_accounts - 非アクティブなユーザーアカウントの分析
• analyze_privileged_access_management - PIM 導入状況の評価
• analyze_service_principal_security - サービスプリンシパルの認証情報リスク分析
• analyze_legacy_authentication_risks - レガシー認証プロトコルのリスク評価
• analyze_conditional_access - 条件付きアクセス ポリシーの分析と推奨事項
• comprehensive_security_review - 環境全体の包括的なセキュリティレビュー

ライセンス

MIT