ROADrecon MCP 服务器

此 MCP（模型上下文协议）服务器为 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() - 评估特权身份管理实施情况
• 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