AI 工作流

像聊天一样问 Wi‑Fi

启用 MCP 后,Codex Desktop、Claude Desktop 等兼容客户端可读取 Wi‑Fi 数据。MCP 默认关闭且仅绑定 127.0.0.1;客户端或模型服务如何处理收到的数据,取决于其政策与配置。问问"哪个信道最不拥挤?"或"附近网络有什么值得注意的?"

三个 JSON 端点

networks

浏览附近所有 Wi‑Fi 网络,包含信号强度、频段、信道、安全性等信息。

detail

按设备地址查看单个网络的详细信息,包含信道宽度等进阶数据。

occupancy

检查每个信道的占用情况,了解各 Wi‑Fi 频段的拥塞程度。

一个配置即可连接

在 WiFi Lens 中开启 MCP 服务器,按客户端格式添加本地 Streamable HTTP 配置。Codex 使用 TOML;Claude Desktop 及其他 JSON 客户端使用 mcpServers。

Codex / Claude + WiFi Lens
Codex Desktop · config.toml
[mcp_servers.wifi-lens]
url = "http://127.0.0.1:19840/"
Claude Desktop · claude_desktop_config.json
{
  "mcpServers": {
    "wifi-lens": {
      "url": "http://127.0.0.1:19840/"
    }
  }
}

什么是 MCP?

MCP(Model Context Protocol,模型上下文协议)是一项开放标准,让 AI 工具能够连接本地数据源和服务。WiFi Lens 内置的 MCP 服务器默认关闭,启用后只绑定 127.0.0.1,并按需提供实时 Wi‑Fi 扫描结果。第三方客户端或模型服务如何处理其接收的数据,取决于其政策与配置。

接口返回什么

每个接口都返回可以直接阅读、也可以传给其他工具的纯 JSON。下面是从 WiFi Lens 实际返回结果中截取的一段示例。

networks

{
  "networks": [
    { "ssid": "HomeNet", "bssid": "A4:2B:…", "band": "5GHz", "channel": 36, "rssi": -48, "security": "WPA2" },
    { "ssid": "Office-5G", "bssid": "9C:3D:…", "band": "5GHz", "channel": 149, "rssi": -61, "security": "WPA3" }
  ]
}

所有可见网络,按信号从强到弱排列。

detail

{
  "ssid": "HomeNet",
  "bssid": "A4:2B:…",
  "band": "5GHz",
  "channel": 36,
  "channelWidth": "80MHz",
  "rssi": -48,
  "noise": -92,
  "security": "WPA2"
}

按 BSSID 查到的单个网络。

occupancy

{
  "band": "5GHz",
  "channels": [
    { "channel": 36, "occupancy": 0.12 },
    { "channel": 149, "occupancy": 0.41 },
    { "channel": 157, "occupancy": 0.08 }
  ]
}

5 GHz 频段各信道的占用情况。

一个真实工作流

假设你在家里书房开视频会议总掉线。与其瞎猜,不如打开 WiFi Lens 让它扫描,然后让你的 AI 助手帮你找出问题。

  1. 问:"现在哪个信道最不拥挤?"——AI 读取占用情况,告诉你一条空闲的信道。
  2. 问:"为什么我的连接比手机还慢?"——它会把你的网络信号、信道、频段和附近其他网络做对比。
  3. 问:"我该在路由器上改什么?"——它会把发现转化成一条具体、只在本地完成的建议。

从设计上就保护隐私

MCP 默认关闭,启用后只绑定 127.0.0.1。WiFi Lens 不会上传 Wi‑Fi 扫描记录;第三方客户端及模型服务如何处理它们读取的数据,取决于其政策与配置。