项目简介

Nextr4y 是一款强大的 Next.js 侦察工具,旨在分析 Next.js 应用程序并提取其内部结构、路由和依赖项等信息。它提供 MCP 服务器模式,允许 LLM 客户端(如 Cursor IDE)通过 Model Context Protocol 远程调用 nextr4y 的扫描功能。

主要功能点

  • Next.js 网站扫描: 识别目标网站是否使用 Next.js 构建,并提取版本、构建ID、路由、资源文件等信息。
  • MCP 服务器模式: 通过 Model Context Protocol 协议提供扫描服务,允许远程客户端发送扫描请求并获取结果。
  • 工具集成: 可以与支持 MCP 协议的 LLM 客户端(如 Cursor IDE)集成,方便在 IDE 中直接使用 nextr4y 进行网站分析。
  • 多种输出格式: 支持 JSON 和文本格式的扫描结果输出。

安装步骤

  1. 环境准备: 确保已安装 Go 语言环境。
  2. 下载 nextr4y: 可以选择以下方式下载 nextr4y:
    • 从源代码编译:
      git clone https://github.com/rodrigopv/nextr4y.git
      cd nextr4y
      go build -o nextr4y ./cmd/nextr4y
    • 使用 'go install':
      go install github.com/rodrigopv/nextr4y/cmd/nextr4y@latest
    • 下载预编译二进制文件: 从 Releases 页面下载适用于您操作系统的预编译版本。

服务器配置

MCP 客户端需要配置连接 nextr4y MCP 服务器的信息。以 Cursor IDE 为例,需要在 '~/.cursor/mcp.json' 文件中添加如下配置:

{
  "mcpServers": {
    "nextr4y": {
      "url": "http://localhost:8080/sse"
    }
  }
}

配置参数说明:

  • 'server name': 'nextr4y' (自定义服务器名称,在 Cursor 中用于标识)
  • 'command': 'nextr4y' (nextr4y 服务器的启动命令)
  • 'args': '["serve"]' (启动服务器的命令参数,这里表示启动 serve 命令,默认监听 'http://0.0.0.0:8080')

如果您需要自定义服务器的 host 和 port,请使用以下 'args' 配置:

{
  "mcpServers": {
    "nextr4y": {
      "url": "http://127.0.0.1:9000/sse",
      "command": "nextr4y",
      "args": ["serve", "--host", "127.0.0.1", "--port", "9000"]
    }
  }
}

参数说明:

  • '"serve"': 指定 nextr4y 运行在 MCP 服务器模式。
  • '"--host", "127.0.0.1"': 指定服务器监听地址为 '127.0.0.1'。
  • '"--port", "9000"': 指定服务器监听端口为 '9000'。

基本使用方法

  1. 启动 MCP 服务器: 在安装 nextr4y 的机器上,打开终端并执行以下命令启动 MCP 服务器(默认监听 'http://0.0.0.0:8080'):
    nextr4y serve
    或者,使用自定义 host 和 port 启动服务器:
    nextr4y serve --host 127.0.0.1 --port 9000
  2. 配置 MCP 客户端: 根据您的 MCP 客户端 (例如 Cursor IDE) 的文档,配置连接到 nextr4y MCP 服务器的信息,通常需要提供服务器 URL ('http://localhost:8080/sse' 或自定义的 URL)。
  3. 使用扫描工具: 在 MCP 客户端中,调用 'nextr4y_scan' 工具,并提供目标 Next.js 网站的 URL 作为参数,即可开始扫描并获取结果。具体操作方式请参考您的 MCP 客户端文档。

例如在 Cursor IDE 中,配置完成后,您可以通过命令或界面操作调用 'nextr4y_scan' 工具,并指定要扫描的网站 URL。扫描结果将以 JSON 或文本格式返回,具体取决于您在客户端的配置或工具的默认行为。

信息

分类

开发者工具