Roadrecon MCP Server

🚀 ROADRecon MCP サーバー

このMCP（モデルコンテキストプロトコル）サーバーは、ClaudeなどのAIアシスタントに、ROADReconのAzure ADデータへのアクセスとセキュリティ分析機能を提供します。

優れたROADtoolsセットはdirkjanmによって開発されており、こちらで見つけることができます：ROADRecon

✨ 主な機能

• リソース：ROADReconインスタンスからAzure ADデータにアクセスします。
• ツール：データに対してセキュリティ分析を実行します。
• プロンプト：一般的なセキュリティタスク用の事前構築された分析テンプレートを提供します。

📦 インストール

前提条件

• Python 3.8以上
• 実行中でWeb GUIにアクセス可能なROADReconインスタンス（デフォルト：http://localhost:5000）
• MCP互換クライアント（Claude Desktopなど）

手順

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

pip install -r requirements.txt

💻 使用例

サーバーの起動

基本的な使用法

# ROADRecon GUIが実行中であることを確認します（デフォルト：http://localhost:5000）
# MCPサーバーを起動します
python roadrecon_mcp_server.py

高度な使用法

# 異なるROADRecon URLを指定する場合
ROADRECON_URL=http://localhost:8080 python roadrecon_mcp_server.py

Claude Desktopとの接続

1. Claude Desktopを開きます。
2. 設定 → サーバー → サーバーを追加 へ移動します。
3. 「実行中のサーバーから追加」を選択します。
4. サーバーがリストに表示されるので、「インストール」をクリックします。

この手順の詳細については、こちらを参照してください：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://azuread - Azure ADデータ
• roadrecon://config - 設定

利用可能なツール

• find_privileged_users() - 高権限のユーザーを見つけます。
• analyze_password_policy() - パスワードポリシーを分析します。
• check_mfa_status() - MFA状態をチェックします。
• list_groups() - すべてのグループをリストします。
• get_group_memberships() - グループメンバーシップを取得します。
• _audit_logins() - ログイン記録を監査します。

利用可能なプロンプト

• 高権限ユーザーを分析する
• セキュリティポリシーの遵守状況をチェックする
• MFAのカバレッジを評価する
• グループ構造とメンバーシップをレビューする
• 未監査の外部アクセスを識別する

📄 ライセンス

MIT