Insight App Sec MCP

InsightAppSec MCP服务器

模型上下文协议（MCP）服务器，为人工智能助手提供对Rapid7 InsightAppSec API的访问，用于应用程序安全扫描、漏洞管理和报告。

概述

此MCP服务器使Claude等AI助手能够与Rapid7 InsightAppSec交互，使您能够：

• 管理应用程序及其安全配置
• 启动并监控安全扫描
• 查询和分类漏洞
• 生成安全报告
• 自动安排扫描时间
• 搜索所有InsightAppSec资源
• 配置身份验证 （OAuth、基于表单、宏、流量文件）
• 管理令牌替换 （CSRF、会话令牌、动态参数）

先决条件

• Node.js 18.0.0或更高版本
• 具有API访问权限的Rapid7 InsightAppSec帐户
• 来自的API密钥 Rapid7洞察平台

安装

来源

# Clone the repository
git clone https://github.com/yourusername/insightappsec-mcp.git
cd insightappsec-mcp

# Install dependencies
npm install

# Build the project
npm run build

配置

创建 .env 基于所提供模板的文件：

cp .env.example .env

编辑 .env 使用您的凭据文件：

INSIGHTAPPSEC_API_KEY=your-api-key-here
INSIGHTAPPSEC_REGION=us

支持的地区：

使用Claude Desktop

将以下内容添加到您的Claude Desktop配置文件中：

窗户： %APPDATA%\Claude\claude_desktop_config.json macOS： ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "insightappsec": {
      "command": "node",
      "args": ["C:/path/to/insightappsec-mcp/build/index.js"],
      "env": {
        "INSIGHTAPPSEC_API_KEY": "your-api-key-here",
        "INSIGHTAPPSEC_REGION": "us"
      }
    }
  }
}

重新启动Claude Desktop以加载MCP服务器。

可用工具

应用程序管理

扫描操作

扫描配置

漏洞管理

调度和自动化

遮光窗

报告

搜索

基础设施

文件管理

支持的文件类型：

• MACRO -记录的身份验证序列（.rec）
• RECORDED_TRAFFIC -HTTP流量捕获（.har、.trec、.saz）
• SELENIUM -浏览器自动化脚本（.html、.side）
• CERTIFICATE -SSL证书（.pfx）
• SWAGGER -API规范（.json、.yaml）
• WSDL -Web服务定义（.wsdl）
• GRAPHQL -GraphQL模式（.graphqls）

身份验证和令牌管理

对话示例

列出应用程序

“在InsightAppSec中显示我的所有应用程序”

助理将使用 list_apps 检索和显示您的应用程序。

启动安全扫描

“使用‘Production Web App’扫描配置启动扫描”

助理将：

1. 使用 list_scan_configs 查找配置
2. 使用 submit_scan 开始扫描
3. 报告扫描ID和状态

检查漏洞状态

“显示所有高严重性漏洞”

助理将使用 search 使用DSL查询：

type: VULNERABILITY
query: vulnerability.severity='HIGH'

监视正在运行的扫描

“扫描abc-123的状态如何？”

助理将使用 get_scan 和 get_scan_execution_details 显示：

• 当前扫描状态
• 进度百分比
• 请求已完成
• 到目前为止发现的漏洞

分类漏洞

“将漏洞xyz-789标记为误报，并添加注释解释原因”

助理将：

1. 使用 update_vulnerability 将状态设置为 FALSE_POSITIVE
2. 使用 add_vulnerability_comment 添加说明

安排定期扫描

“每周一凌晨2点为生产应用程序设置每周扫描”

助理将使用 create_schedule 与：

• 频率： WEEKLY
• 开始时间：下周一凌晨2:00 UTC

配置OAuth身份验证

“为API扫描设置OAuth客户端凭据身份验证”

助理将使用 configure_oauth 与：

• 资助类型： CLIENT_CREDENTIALS
• 令牌URL、客户端ID、客户端密钥

为CSRF设置令牌替换

“配置扫描以自动处理CSRF令牌”

助理将使用 configure_csrf_handling 与：

• auto_detect: true
• 令牌名称的可选正则表达式模式

上传身份验证宏

“上传我录制的登录宏进行扫描”

助理将：

1. 使用 create_file 创建元数据（类型：MACRO）
2. 使用 upload_file_content 具有base64编码的宏内容
3. 使用 configure_macro_auth 将其链接到扫描配置

搜索查询语法

这 search 该工具支持强大的DSL来查询资源：

运算符

可搜索资源类型

• VULNERABILITY
• SCAN
• SCAN_CONFIG
• APP
• SCHEDULE
• BLACKOUT
• MODULE
• ATTACK_TEMPLATE
• ENGINE
• ENGINE_GROUP

查询示例

# Find critical vulnerabilities in production apps
type: VULNERABILITY
query: vulnerability.severity='HIGH' AND app.name CONTAINS 'prod'

# Find running scans
type: SCAN
query: scan.status='RUNNING'

# Find scan configs without recent scans
type: SCAN_CONFIG
query: scan_config.last_scan_date "

1. 配置扫描以使用它：

configure_macro_auth:
  scan_config_id: "uuid"
  macro_file_id: "uuid"
  replay_speed: 1.0

漏洞状态

严重级别

发展

项目结构

insightappsec-mcp/
├── src/
│   ├── index.ts              # Entry point
│   ├── config.ts             # Configuration management
│   ├── client/
│   │   └── api-client.ts     # HTTP client for InsightAppSec API
│   ├── schemas/
│   │   └── common.ts         # Shared Zod schemas
│   ├── tools/
│   │   ├── apps.ts           # Application management tools
│   │   ├── scans.ts          # Scan operation tools
│   │   ├── scan-configs.ts   # Scan configuration tools
│   │   ├── vulnerabilities.ts # Vulnerability management tools
│   │   ├── schedules.ts      # Schedule management tools
│   │   ├── blackouts.ts      # Blackout window tools
│   │   ├── engines.ts        # Engine management tools
│   │   ├── reports.ts        # Reporting tools
│   │   ├── search.ts         # Search tool
│   │   ├── files.ts          # File management tools
│   │   └── auth.ts           # Authentication configuration tools
│   └── utils/
│       └── response-formatter.ts  # MCP response formatting
├── build/                    # Compiled JavaScript output
├── package.json
├── tsconfig.json
└── .env.example

脚本

# Build the project
npm run build

# Run in development mode
npm run dev

# Type checking
npm run typecheck

# Run tests
npm test

添加新工具

1. 在中创建或修改工具文件 src/tools/
2. 使用 server.tool() 注册工具的方法：

server.tool(
  "tool_name",
  "Tool description",
  {
    param1: z.string().describe("Parameter description"),
    param2: z.number().optional().describe("Optional parameter"),
  },
  async ({ param1, param2 }) => {
    const result = await client.get("/endpoint");

    if (result.error) {
      return formatErrorResponse(result.error);
    }

    return formatResponse(result.data);
  }
);

1. 导入并注册 src/index.ts

错误处理

服务器正常处理常见的API错误：

错误响应包括：

• 状态码
• 错误信息
• 相关ID（用于Rapid7支持）
• 详细的错误信息（如果可用）

api参考

此MCP服务器包装 Rapid7 InsightAppSec API v1.

有关API的详细文档，请参阅：

• InsightAppSec API文档
• 入门指南
• API使用案例

许可证

麻省理工学院

贡献

欢迎投稿！请随时提交问题和拉取请求。

支持

• 有关InsightAppSec API问题，请联系 Rapid7支持
• 对于MCP服务器问题，打开GitHub问题