像聊天一样问 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[mcp_servers.wifi-lens] url = "http://127.0.0.1:19840/"
{
"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 助手帮你找出问题。
- 问:"现在哪个信道最不拥挤?"——AI 读取占用情况,告诉你一条空闲的信道。
- 问:"为什么我的连接比手机还慢?"——它会把你的网络信号、信道、频段和附近其他网络做对比。
- 问:"我该在路由器上改什么?"——它会把发现转化成一条具体、只在本地完成的建议。
从设计上就保护隐私
MCP 默认关闭,启用后只绑定 127.0.0.1。WiFi Lens 不会上传 Wi‑Fi 扫描记录;第三方客户端及模型服务如何处理它们读取的数据,取决于其政策与配置。