MCP Scan
MCP Scan 提供商（Type：MCP Scan，Sub-type：Intranet Scan）通过 HTTP 探测一个或多个内网 CIDR 网段，报告哪些主机在线、其中哪些提供了 MCP 服务器。对每台在线主机，Casdoor 会依次尝试配置的端口 / 路径组合，把响应为 MCP 服务 器的接口记录下来。发现的服务器可以在 Servers 页面管理，例如作为 MCP 服务器。
配置提供商
- 进入 Providers → Add。
- 把 Category 设为 Scan，Type 设为 MCP Scan，Sub-type 设为 Intranet Scan。
- 填写下面的扫描目标字段，然后点击 Save。
| 字段 | 映射的工具 | 示例 |
|---|---|---|
| 主机 | 要扫描的一个或多个 CIDR 网段。 | 127.0.0.1/32, 10.0.0.0/24, 172.16.0.0/24, 192.168.1.0/24 |
| Port | 在每台主机上要探测的端口. 留空时默认为 3000、8080、80。 | 80, 3000, 8080 |
| Path | 在每个开放端口上探测的 HTTP 路径。留空时默认为 /、/mcp、/sse、/mcp/sse。 | /, /mcp, /sse, /mcp/sse |
每个字段都可以填多个值：输入一个值后按 Enter 添加，或从建议列表中选择。
提示
目标网段尽量缩小。扫描大网段（例如整个 /16）会产生大量“主机 × 端口 × 路径”探测，耗时更长。单次扫描最多 1024 台主机。
运行扫描
可以在两个地方触发扫描。必须先保存提供商：新建提供商还没保存时，扫描按钮不可用。
在提供商页面
打开已保存的扫描提供商，点击 Scan server。结果显示在按钮下方的表格中，汇总：
- Scanned hosts：探测的主机数。
- Online hosts：有响应的主机。
- Found servers：在这些主机上发现的 MCP 服务器。
在 Servers 页面
- 进入 Servers，点击 Scan server。
- 选择一个扫描提供商（只列出 Category 为 Scan、Type 为 MCP Scan、Sub-type 为 Intranet Scan 的提供商）并运行扫描。
- 可以直接从结果中把发现的服务器加到 Casdoor 的 Servers 列表。扫描到的服务器导入时，显示名称形如
Scanned MCP <host>:<port>，并带上发现的地址。
默认值与限制
| 设置 | 值 |
|---|---|
| 默认端口 | 3000, 8080, 80 |
| 默认路径 | /, /mcp, /sse, /mcp/sse |
| 每台主机的请求超时 | 1200 ms |
| 最大并发探测数 | 32 |
| 每次扫描的最大主机数 | 1024 |
API
从 Servers 页面触发的扫描调用：
POST /api/sync-intranet-servers
请求体：
{
"provider": "<owner>/<provider-name>"
}
主机、端口和路径目标从所引用提供商的配置中读取，所以请求体中不传扫描参数。响应返回扫描的 CIDR 网段、扫描的主机数、在线主机列表和发现的服务器。
迁移说明
以前内置在 Casdoor 中的内网服务器扫描，现在改为以扫描提供商的形式实现。如果你依赖旧的内置 MCP 扫描，请按上面的方法创建一个 MCP Scan / Intranet Scan 提供商，并在 Servers 页面扫描时引用它。