JinDaGe - roadrecon_mcp_server MCP Details

article

README

🚀 ROADRecon MCP 服务器

此MCP（模型上下文协议）服务器为Claude等AI助手提供了安全分析功能，使其能够访问您的ROADRecon Azure AD数据。借助该服务器，您可以更高效地对Azure AD数据进行安全分析。

🚀 快速开始

此MCP服务器为Claude等AI助手提供了安全分析功能，使其能够访问您的ROADRecon Azure AD数据。借助该服务器，您可以更高效地对Azure AD数据进行安全分析。

✨ 主要特性

资源：从您的ROADRecon实例访问Azure AD数据
工具：在数据上执行安全分析
提示：用于常见安全任务的预建分析模板

📦 安装指南

先决条件

Python 3.8+
正在运行且Web GUI可访问的ROADRecon实例（默认：http://localhost:5000）
MCP兼容客户端（Claude Desktop等）

安装步骤

克隆此仓库
安装依赖项：

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连接

打开Claude Desktop
转到设置 → 服务器 → 添加服务器
选择“从运行中的服务器添加”
服务器应出现在列表中，点击“安装”

有关此步骤的更多详细信息，请参见此处：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覆盖范围 | 评估MFA的覆盖情况 | | 审查组结构和成员身份 | 审查组的结构和成员身份 | | 识别未审核的外部访问 | 识别未经过审核的外部访问 |

📄 许可证

本项目采用MIT许可证。

roadrecon_mcp_server