Xray Mcp

Xray MCP 服务

这是一个增强型 MCP（Model Context Protocol）服务，为 ModelScope 托管平台提供 xray 漏洞扫描功能。

功能

• xray_scan：对目标 URL 执行漏洞扫描

  • 支持 basic-crawler 和 phantasm-crawler 扫描类型
  • 可配置超时
  • 支持插件和 POC
  • 以 JSON 格式输出详细结果

• xray_version：获取 xray 版本信息

• xray_start_proxy：以被动代理模式启动 xray（计划中）

  • 可配置代理端口
  • 实时漏洞检测

• xray_stop_proxy：停止正在运行的 xray 代理（计划中）

• xray_service_scan：扫描非 HTTP 目标上的服务（计划中）

  • 端口范围扫描
  • 服务检测

安装

1. 安装 Python 3.7+
2. 从 https://github.com/chaitin/xray 安装 xray
3. 设置 XRAY_PATH 环境变量，使其指向 xray 二进制文件：

   export XRAY_PATH=/path/to/xray
   

配置

环境变量：

• XRAY_PATH：xray 二进制文件的路径（默认值："xray"）
• XRAY_CONFIG_DIR：配置目录（默认值："~/.xray-mcp"）
• XRAY_OUTPUT_DIR：扫描结果的输出目录（默认值：系统临时目录）

用法

用于 ModelScope MCP

此服务专为配合 ModelScope 的 MCP 平台而设计。该服务实现了 MCP 协议，可集成到 ModelScope 生态系统中。

独立使用

运行服务：

python server.py

服务从 stdin 读取 JSON-RPC 请求，并将响应写入 stdout。

请求示例

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "xray_scan",
    "arguments": {
      "target": "http://example.com",
      "scan_type": "basic-crawler",
      "timeout": 300
    }
  }
}

可用工具

xray_scan

对目标 URL 执行漏洞扫描。

参数：

• target（必需）：要扫描的目标 URL
• scan_type（可选）：扫描类型——"basic-crawler" 或 "phantasm-crawler"（默认值："basic-crawler"）
• timeout（可选）：扫描超时时间，单位为秒（默认值：300）
• plugins（可选）：要使用的插件列表，以逗号分隔
• poc（可选）：扫描时使用的 POC

xray_version

获取已安装的 xray 扫描器版本信息。

无需参数。

xray_start_proxy（计划中）

以被动代理模式启动 xray，进行实时扫描。

参数：

• port（可选）：要监听的代理端口（默认值：7777）

xray_stop_proxy（计划中）

停止正在运行的 xray 代理。

无需参数。

xray_service_scan（计划中）

扫描非 HTTP 目标上的服务。

参数：

• target（必需）：要扫描的目标主机/IP
• port_range（可选）：要扫描的端口范围（默认值："1-65535"）
• timeout（可选）：扫描超时时间，单位为秒（默认值：300）

安全注意事项

• 服务会使用用户提供的 URL 执行 xray
• 部署时请实施适当的访问控制
• 生产环境中请考虑设置速率限制
• 验证并清理所有输入

许可证

MIT 许可证