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() - 评估 Privileged Identity Management 的实施情况
• 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 - 身份安全配置分析
• analyze_stale_accounts - 非活动用户账户分析
• analyze_privileged_access_management - PIM 实施情况评估
• analyze_service_principal_security - 服务主体凭据风险分析
• analyze_legacy_authentication_risks - 旧版身份验证协议风险评估
• analyze_conditional_access - 条件访问策略分析与建议
• comprehensive_security_review - 对整个环境进行全面安全审查

许可证

MIT