WPX AI MCP 本地设备连接指南
仅限本机 127.0.0.1:8765

CONNECT YOUR DEVICE TO AI

WPX AI MCP

复制粘贴，一步连上 AI。

只需点击“复制配置”，粘贴到 AI Agent 平台， 剩下的连接与配置，AI 自动完成。

连上后，直接告诉 AI 你想测什么、分析什么。

轻松开始 试试示例提问
传输
Streamable HTTP
地址
127.0.0.1
设备
WPX-01A / WPX-S1
WPX AI MCP 面板：服务正在运行，已连接 WPX S1，左下角为复制配置按钮。
WPX AI MCP 运行界面 · 点击查看大图 点击左下角“复制配置”，粘贴给 AI Agent 就这么简单，连接与配置自动完成。

01

QUICK START

只需一步，轻松连接

设备已连接、AI MCP 面板显示“正在运行”后，就可以开始。

复制配置，粘贴给 AI Agent，就完成了。

点击面板左下角“复制配置”，把内容粘贴到支持 MCP、可访问本机服务的 AI Agent 平台。AI 会自动完成配置并连接设备。

连上后，试着问 AI：“当前设备状态怎么样？”

关闭面板不会停止服务。AI MCP 与当前设备 GUI 共享动作和数据；点击“停止 MCP”也不会断开设备或停止采集。

想开始测试？直接告诉 AI

例如：“检查设备状态，开始采集并分析数据。”AI 会根据你的指令调用相应工具。

02

COPY. PASTE. CONNECT.

配置交给 AI，你只管提问

从 WPX AI MCP 面板复制完整内容，粘贴给 AI Agent 即可。

一次复制粘贴，配置和连接一起完成。

连接信息已经包含在复制的内容中，AI Agent 会自动处理。连上后，就能用自然语言查询设备状态、读取数据和分析 Qi 协议。

连接成功后，试试这些提问
手动配置参考（可选）
真实 token 以状态窗口的“复制配置”为准

下面是格式模板。占位符不能直接连接服务；每次启动后，都应从当前状态窗口重新复制包含真实令牌的配置。

通用客户端

Streamable HTTP JSON

{
  "name": "WPX AI MCP",
  "transport": "streamable-http",
  "url": "http://127.0.0.1:8765/mcp",
  "headers": {
    "Authorization": "Bearer <复制配置生成的真实令牌>"
  }
}
Codex

config.toml

[mcp_servers.wpx_ai]
url = "http://127.0.0.1:8765/mcp"
http_headers = { Authorization = "Bearer <TOKEN>" }
连接成功标志 客户端能列出以 device_、wpx01a_ 或 wpxs1_ 开头的工具。
POST /mcp

03

TOOL REFERENCE

完整工具列表

服务只公开与当前设备类型匹配的工具。未标注参数的工具均为无参数调用。

通用设备

所有支持 MCP 的设备都提供。

工具参数用途
device_get_status无读取服务、设备连接和当前运行状态。
device_get_info无读取设备身份、版本和能力信息。

WPX-01A

身份刷新与显式遥测控制。

工具参数用途
wpx01a_refresh_identity无主动刷新序列号、固件和硬件身份信息。
wpx01a_start_telemetry无开始接收 WPX-01A 实时遥测。
wpx01a_stop_telemetry无停止遥测接收并保留已经缓存的数据。
wpx01a_get_latest_telemetry无读取最近一条可用遥测样本。
wpx01a_get_telemetry_history seconds=60
max_points=120		 读取指定时间窗内的下采样遥测历史。

WPX-S1

采集生命周期、协议包、频率与管线诊断。

工具参数用途
wpxs1_start_capture无从停止状态开始新的采集会话。
wpxs1_pause_capture无暂停当前采集的对外数据交付。
wpxs1_resume_capture reset_time_base=true 恢复暂停的采集；默认重置显示时间基准。
wpxs1_stop_capture无停止当前采集并冻结已完成状态。
wpxs1_get_capture_status无读取采集状态、会话和计数摘要。
wpxs1_get_stream_info无读取设备声明的采样率和流参数。
wpxs1_get_recent_packets cursor=null
limit=50
modulation=null
valid_only=false 		分页读取最近协议包，可按调制类型和有效性筛选。
wpxs1_get_latest_frequency无读取最近的载波频率状态。
wpxs1_get_latest_heartbeat无读取设备最近一次 heartbeat 与错误计数。
wpxs1_get_pipeline_statistics无读取 USB、队列和解析管线的累计统计。

04

PROMPT EXAMPLES

示例提问

先让 AI 检查状态，再明确要求是否启动遥测或采集。

通用检查device_*

检查当前连接设备的状态、型号、序列号和固件版本，并指出可用的设备专用工具。

WPX-01A 趋势wpx01a_*

开始 WPX-01A 遥测，等待采样稳定后读取最近 60 秒、最多 120 点的历史，并总结功率、电压、电流和温度变化。

WPX-S1 只读检查wpxs1_*

不要启动采集。先读取 WPX-S1 的采集状态、stream info、最近 heartbeat 和 pipeline statistics，判断设备链路是否健康。

WPX-S1 包分析wpxs1_get_recent_packets

启动 WPX-S1 采集，读取最近 50 个有效协议包，按 ASK/FSK 分类并总结重复 Header、校验异常和时间顺序。

05

SECURITY BOUNDARIES

安全边界

MCP 能操作真实硬件。把本地端点、令牌和设备所有权视为同一条安全边界。

仅限本机

服务只监听 127.0.0.1，不要代理、转发或改成局域网地址。

保护令牌

不要公开分享含令牌的配置或截图；服务重启后，请从面板重新复制当前配置。

单一客户端

一次只连接一个 AI 客户端，避免多个代理同时改变采集与遥测状态。

与设备 GUI 协同

AI MCP 与当前设备 GUI 共享动作和数据。操作前先检查当前状态，避免重复启动或停止采集。

离开前停止服务 如需结束测试，先停止采集或遥测，再点击“停止 MCP”。关闭面板不会停止服务，停止 MCP 也不会自动停止采集。

06

TROUBLESHOOTING

故障排查

从状态窗口、连接配置和设备采集状态三个层面依次检查。

AI 客户端无法连接端点

打开 AI MCP 面板，确认服务显示“正在运行”且设备已连接，再重新复制配置并粘贴到 AI Agent 平台。平台须支持 MCP 并能访问本机的 http://127.0.0.1:8765/mcp，传输类型为 Streamable HTTP。

收到 401 或令牌错误

回到当前 AI MCP 面板重新点击“复制配置”，将完整内容粘贴到 AI Agent 平台，让 Agent 更新连接配置。

8765 端口已被占用

先检查是否已有正在运行的 WPX AI MCP 服务；如需重启，在原面板点击“停止 MCP”后再启动。仅关闭面板不会释放端口。

客户端看不到设备专用工具

先调用 device_get_status 和 device_get_info。确认设备型号正确、连接未断开，并在修复后让客户端刷新 MCP 工具列表。

WPX-01A 没有遥测数据

先检查当前遥测状态；尚未启动时调用 wpx01a_start_telemetry，等待设备返回样本，再读取 latest 或 history。

WPX-S1 没有协议包或频率数据

先检查 capture status 和 stream info；尚未采集时调用 wpxs1_start_capture，暂停状态使用 wpxs1_resume_capture。

关闭面板或停止 MCP，会影响设备吗？

关闭面板不会停止 MCP 服务；点击“停止 MCP”会停止 AI 连接服务，但不会断开设备或停止采集。如需结束采集，请在设备 GUI 中操作或在停止 MCP 前让 AI 执行停止指令。