ARL MCP Improved v2.0

专为AI安全分析设计的ARL MCP服务器，提供48个工具，覆盖漏洞扫描、敏感信息泄露检测、GitHub代码泄露监控等功能。

改进版的 ARL (Asset Reconnaissance Lighthouse) MCP 服务器，支持通过环境变量配置，提供完整的 ARL API 集成。

✨ 核心特性

🔒 安全检测（19个工具）

• Nuclei漏洞扫描 - 详细的漏洞信息和匹配内容

• POC管理 - 漏洞验证脚本管理

• 敏感信息泄露检测 - 配置文件、备份文件、数据库泄露

• GitHub代码泄露监控 - 监控GitHub上的敏感信息

• Web指纹识别 - 自定义指纹规则

• SSL证书查询 - 证书过期和安全检查

🤖 AI分析专用（3个工具）

• 漏洞汇总分析 - 一键获取所有漏洞统计

• 敏感信息泄露汇总 - 高风险泄露识别

• GitHub泄露汇总 - 代码泄露风险评估

🚀 自动化功能

• 监控任务 - 定期自动扫描

• 策略管理 - 自定义扫描配置

• 数据导出 - CSV格式导出

🛠️ 基础功能

• 🔧 灵活配置 - 支持环境变量配置 ARL URL 和 Token

• 🌍 双语支持 - 自动检测并支持中英文响应

• 📊 批量操作 - 支持批量任务管理和数据导出

• 🔍 高级搜索 - 支持多条件过滤和精确查询

• 🚀 易于集成 - 与 Kiro IDE 和其他 MCP 客户端无缝集成

Related MCP server: github-security-mcp

📊 工具统计

• 总计：48个工具

• 基础工具：3个

• 任务管理：8个

• 资产查询：12个

• 漏洞扫描：5个

• GitHub监控：4个

• 指纹识别：3个

• 策略管理：3个

• 监控任务：3个

• 数据导出：3个

• AI分析：3个

• API覆盖率：45%

🚀 快速开始

AI安全评估（3步完成）

# 1. 获取漏洞概况
vuln_summary = get_vulnerability_summary()

# 2. 获取敏感信息泄露概况
leak_summary = get_sensitive_leak_summary()

# 3. 获取GitHub代码泄露概况
github_summary = get_github_leak_summary()

# AI分析并生成报告

📦 安装

前置要求

• Python 3.10+

• ARL 服务器（运行中）

• ARL API Token

使用 uvx（推荐）

# 在 MCP 配置中添加
{
  "mcpServers": {
    "arl": {
      "command": "uvx",
      "args": ["--from", ".", "arl-mcp-improved"],
      "env": {
        "ARL_URL": "https://127.0.0.1:5192",
        "ARL_TOKEN": "your_token_here"
      }
    }
  }
}

使用 pip

# 克隆仓库
git clone <repository-url>
cd arl-mcp-improved

# 安装依赖
pip install -e .

# 设置环境变量
export ARL_URL="https://127.0.0.1:5192"
export ARL_TOKEN="your_token_here"

# 运行服务器
python server.py

🔧 配置

环境变量

获取 ARL Token

1. 登录 ARL Web 界面

2. 进入 "用户设置" 或 "API 设置"

3. 生成或复制 API Token

4. 将 Token 配置到环境变量中

📚 文档

快速导航

• 📖 完整工具列表 - 58个工具的详细说明

• 🔒 安全检测工具 - 19个安全相关工具

• 🤖 AI使用指南 - AI安全分析完整指南

• 📋 缺失API分析 - 未来扩展计划

• ⚙️ 配置指南 - 详细配置说明

• 🔄 更新日志 - 版本更新记录

💡 使用示例

创建扫描任务

result = add_scan_task_and_prompt(
    name="测试扫描",
    target="example.com",
    domain_brute=True,
    port_scan=True,
    file_leak=True
)

查询漏洞

# 查询所有严重漏洞
critical_vulns = search_nuclei_result_detail(
    severity="critical",
    size=100
)

# 获取漏洞汇总（AI分析专用）
summary = get_vulnerability_summary()

检测敏感信息泄露

# 查询文件泄露
leaks = search_fileleak_detail(size=1000)

# 获取泄露汇总（AI分析专用）
leak_summary = get_sensitive_leak_summary()

监控GitHub代码泄露

# 创建监控任务
create_github_monitor(
    name="example.com监控",
    keywords="example.com api_key password secret",
    cron="0 */6 * * *"
)

# 查询泄露结果
results = search_github_results(keyword="example.com")

# 获取泄露汇总（AI分析专用）
github_summary = get_github_leak_summary()

设置持续监控

# 创建定期扫描任务
create_scheduler(
    name="每日安全扫描",
    target="example.com",
    cron="0 2 * * *"  # 每天凌晨2点
)

🎯 AI分析场景

场景1：全面安全评估

# 一键获取完整安全状况
vuln_summary = get_vulnerability_summary()
leak_summary = get_sensitive_leak_summary()
github_summary = get_github_leak_summary()

# AI生成综合报告

场景2：漏洞深度分析

# 查询高危漏洞
critical = search_nuclei_result_detail(severity="critical")
high = search_nuclei_result_detail(severity="high")

# AI分析并生成修复方案

场景3：敏感信息泄露调查

# 查询所有泄露
leaks = search_fileleak_detail(size=1000)

# AI识别高风险泄露并生成应急响应计划

🔍 核心工具分类

任务管理（8个）

• add_scan_task_and_prompt - 创建扫描任务

• add_scan_task_with_policy - 使用策略创建任务

• list_all_tasks - 列出所有任务

• query_task_status - 查询任务状态

• get_task_detail - 获取任务详情

• query_and_extract - 提取任务结果

• delete_task - 删除任务

• stop_task - 停止任务

• export_task_data - 导出任务数据

资产查询（11个）

• get_all_subdomains - 获取子域名

• query_ip_list - 获取IP列表

• query_site_list - 获取站点列表

• query_fileleak_list - 获取文件泄露列表

• search_asset_domain - 搜索域名资产

• search_asset_ip - 搜索IP资产

• search_site - 搜索站点

• search_cert - 搜索SSL证书

• search_url - 搜索URL

• search_fileleak_detail - 搜索文件泄露详情

安全扫描（19个）

• search_nuclei_result_detail - Nuclei漏洞扫描

• list_poc - 列出POC

• sync_poc - 同步POC库

• delete_poc - 删除POC

• create_github_monitor - 创建GitHub监控

• list_github_monitors - 列出GitHub监控

• search_github_results - 搜索GitHub泄露

• delete_github_monitor - 删除GitHub监控

• list_fingerprints - 列出指纹

• add_fingerprint - 添加指纹

• delete_fingerprint - 删除指纹

• get_vulnerability_summary - 漏洞汇总（AI专用）

• get_sensitive_leak_summary - 泄露汇总（AI专用）

• get_github_leak_summary - GitHub泄露汇总（AI专用）

自动化（6个）

• create_scheduler - 创建监控任务

• list_schedulers - 列出监控任务

• delete_scheduler - 删除监控任务

• create_policy - 创建策略

• list_policies - 列出策略

• delete_policy - 删除策略

数据导出（3个）

• export_domain_csv - 导出域名

• export_ip_csv - 导出IP

• export_site_csv - 导出站点

🤝 贡献

欢迎提交 Issue 和 Pull Request！

📄 许可证

MIT License

🔗 相关链接

• ARL 项目

• MCP 协议

• FastMCP

📞 支持

如有问题，请：

1. 查看 AI使用指南

2. 查看 配置指南

3. 提交 Issue

v2.0 更新亮点：

• ✨ 新增33个工具（从25个增加到58个）

• 🔒 完整的安全检测功能

• 🤖 3个AI分析专用工具

• 📊 API覆盖率从22%提升到51%

• 📚 完整的AI使用指南