Tenable MCP (Management Control Panel)

Tenable MCP（管理控制面板）

一个 Spring Boot 应用，提供全面的界面，用于管理和可视化 Tenable.io 安全数据。

功能

• 配置管理

  • 轻松配置 Tenable.io API 凭据
  • 支持自定义 API 端点
  • 可配置超时和重试策略

• 安全可视化

  • 按严重性划分的漏洞分布
  • 资产漏洞趋势
  • 高漏洞风险资产分析
  • 漏洞年龄分布
  • 修复进度跟踪
  • 资产风险评分分布
  • 漏洞类别分析

• 报告

  • 全面的 CSV 导出
  • 详细的安全态势摘要
  • 可自定义的时间范围筛选

先决条件

• Java 17 或更高版本
• Gradle 7.x 或更高版本（项目中已包含）
• Docker（可选，用于容器化部署）
• Tenable.io API 凭据

快速开始

1. 克隆仓库：

   git clone https://github.com/yourusername/tenablemcp.git
   cd tenablemcp
   

2. 运行设置脚本：

   chmod +x setup.sh
   ./setup.sh
   

3. 更新配置： 编辑 src/main/resources/application.yml，填入你的 Tenable.io 凭据：

   tenable:
     apiKey: "your-api-key"
     accessKey: "your-access-key"
     secretKey: "your-secret-key"
     baseUrl: "https://cloud.tenable.com"
   

4. 运行应用：

   ./gradlew bootRun
   

使用 Docker 运行

1. 构建 Docker 镜像：

   docker build -t tenable-mcp .
   

2. 运行容器：

   docker run -p 8080:8080 tenable-mcp
   

API 端点

配置

• GET /api/config

  • 获取当前配置
  • 响应：当前配置设置

• POST /api/config

  • 更新配置
  • 请求正文：包含配置参数的 JSON
  • 示例：

    {
      "accessKey": "your-access-key",
      "secretKey": "your-secret-key",
      "baseUrl": "https://cloud.tenable.com"
    }
    

可视化

• GET /api/v1/visualizations/report

  • 获取综合安全报告
  • 查询参数：
    • startTime（可选）：ISO-8601 格式的开始时间
    • endTime（可选）：ISO-8601 格式的结束时间
  • 响应：包含多个可视化内容的 JSON

• GET /api/v1/visualizations/export/vulnerabilities

  • 将报告导出为 CSV
  • 查询参数：
    • startTime（可选）：ISO-8601 格式的开始时间
    • endTime（可选）：ISO-8601 格式的结束时间
  • 响应：CSV 文件下载

可视化类型

1. 漏洞分布

   • 显示按严重性划分的分布饼图
   • 使用颜色编码，便于解读

2. 资产漏洞趋势

   • 显示随时间变化的漏洞趋势折线图
   • 有助于跟踪安全态势的改善情况

3. 高漏洞风险资产

   • 显示漏洞风险最高资产的柱状图
   • 有助于确定修复工作的优先级

4. 漏洞年龄分布

   • 显示漏洞年龄范围的饼图
   • 有助于识别长期未处理的漏洞

5. 修复进度

   • 显示已修复和未解决漏洞的环形图
   • 跟踪修复成效

6. 资产风险评分分布

   • 显示资产风险评分分布的柱状图
   • 有助于识别高风险资产

开发

项目结构

src/main/kotlin/com/tenable/mcp/
├── config/         # Configuration classes
├── controller/     # REST controllers
├── service/        # Business logic
├── client/         # Tenable.io API client
└── model/          # Data models

构建

./gradlew clean build

运行测试

./gradlew test

贡献

1. Fork 仓库
2. 创建功能分支
3. 提交更改
4. 推送到该分支
5. 创建 Pull Request

许可证

本项目采用 MIT License 许可，详情请参阅 LICENSE 文件。

支持

如需支持，请在 GitHub 仓库中提交 issue，或联系维护人员。