OpenClaw MCP Scanner

一个基于 Python/FastMCP 的本地 MCP Server，用来扫描并发现用户指定 IP 或 IP 段中的 OpenClaw 服务。

运行环境固定为 Python 3.13。

支持两种探测方式：

HTTP 探测：默认扫描 18789/tcp，通过 OpenClaw 特征响应头和页面内容识别服务
mDNS/UDP 探测：默认扫描 5353/udp，发送 _clawdbot-gw._tcp.local PTR 查询并匹配 clawdbot、role=gateway

安装

source ~/venv3.13/bin/activate
pip install -e .

如果直接运行 python openclaw_mcp.py，请先确保当前 Python 环境就是 ~/venv3.13，并且已经安装了依赖；否则脚本会提示缺少 mcp 或 pydantic。

Claude Code 中配置 MCP

在 Claude Code 的 MCP 配置里新增一项 stdio 服务器，把下面示例里的占位符换成你本机路径：

| 占位符 | 含义 | |--------|------| | <PYTHON_EXE> | 已安装本项目依赖的 Python 可执行文件（例如虚拟环境里的 python） | | <OPENCLAW_MCP_SCRIPT> | 本仓库中 openclaw_mcp.py 的绝对路径 |

配置片段示例（名称可自定，与下方 openclaw-scanner 一致即可；把占位符换成你本机真实路径，勿照搬示例字面值）：

"openclaw-scanner": {
  "command": "<PYTHON_EXE>",
  "args": [
    "<OPENCLAW_MCP_SCRIPT>"
  ],
  "env": {},
  "type": "stdio"
}

说明：command 必须是可执行的 python（或 python3），args 第一项是脚本的完整路径；若依赖装在虚拟环境里，请使用该环境下的解释器路径，避免系统 Python 缺少 mcp / pydantic。

启动

默认使用 stdio 方式运行，适合本地 MCP 客户端直接拉起：

python openclaw_mcp.py

如果你希望以 Streamable HTTP 方式运行：

python openclaw_mcp.py --transport streamable-http --http-port 8000

提供的工具

`openclaw_discover_services`

组合扫描工具。

输入：
- target: 单个 IP、CIDR、start-end IP 范围，或逗号分隔组合
- port: 可选
规则：
- port 为空时，同时执行：
  - 18789/tcp HTTP 探测
  - 5353/udp mDNS 探测
- port = 5353 时，仅执行 mDNS 探测
- 其他指定端口时，执行 HTTP 探测

示例：

{
  "target": "192.168.1.0/24"
}

{
  "target": "192.168.1.10-192.168.1.20",
  "port": 18789
}

`openclaw_probe_http`

只执行 HTTP 特征探测，默认端口 18789。

`openclaw_probe_mdns`

只执行 mDNS/UDP 特征探测，默认端口 5353。

目标格式

支持以下 target 写法：

192.168.1.10
192.168.1.0/24
192.168.1.10-192.168.1.20
192.168.1.10,192.168.1.20,192.168.2.0/28

返回结果

工具返回结构化结果，包括：

ports_scanned
protocols_scanned
total_hosts
total_probes
match_count
matches
errors

其中 matches 会返回命中的主机、端口、协议、命中证据，以及响应预览；mDNS 命中时还会尽量提取 displayName。

说明

为避免误扫过大网段，目标展开上限为 4096 个地址
HTTP 探测使用短超时 TCP 请求
mDNS 探测实现参考你提供的 nuclei 模板逻辑

MCP Servers