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

LOCAL DEVICE BRIDGE

WPX AI MCP

在设备管理器中把已选择的 WPX 设备切换到 AI MCP 模式， 由本地服务独占设备连接，再让支持 MCP 的 AI 客户端安全调用测量与分析工具。

开始连接 查看连接配置
传输
Streamable HTTP
地址
127.0.0.1
设备
WPX-01A / WPX-S1
WPX-01A 无线功率测试仪
功率测试 WPX-01A
WPX-S1 Qi 协议分析仪
协议采集 WPX-S1

01

QUICK START

快速开始

设备连接与 AI 客户端连接是两个独立步骤，按下面顺序操作。

  1. 1

    选择设备

    打开 WPX 设备管理器，等待扫描完成，然后选中一台正常模式设备。

  2. 2

    切换模式

    选择“AI MCP”模式并启动。普通设备窗口与 MCP 模式不能同时占用设备。

  3. 3

    等待就绪

    状态显示“服务已就绪”后再配置客户端。状态窗口须保持打开。

  4. 4

    复制并连接

    从状态窗口点击“复制配置”，粘贴到 AI 客户端并完成 MCP 连接。

AI MCP 状态 服务已就绪
WPX-S1 · COM7
本地端点 http://127.0.0.1:8765/mcp
采集默认不启动

WPX-S1 进入 MCP 模式后只建立设备与服务连接。只有调用 wpxs1_start_capture 后才开始采集；WPX-01A 遥测也需显式启动。

02

CLIENT CONFIGURATION

复制配置

所有客户端都连接同一个本机 Streamable HTTP 端点。

真实 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，不要代理、转发或改成局域网地址。

保护令牌

不要分享配置、截图或 token；停服后旧令牌不应继续使用。

单一客户端

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

设备独占

MCP 模式期间不要再打开普通设备窗口或其他串口工具。

离开前停止服务 先停止采集或遥测，再在状态窗口停止 MCP 服务，确认设备已经释放。

06

TROUBLESHOOTING

故障排查

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

AI 客户端无法连接端点

确认状态窗口仍然打开且显示“服务已就绪”，地址必须是 http://127.0.0.1:8765/mcp，传输类型必须是 Streamable HTTP。

收到 401 或令牌错误

不要手动复用旧 token。回到当前状态窗口重新点击“复制配置”，完整替换客户端中的 URL 与 Authorization header。

8765 端口已被占用

关闭另一份 WPX AI MCP 状态窗口或占用该端口的旧进程，然后重新启动服务。不要把服务改为对外网卡地址。

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

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

WPX-01A 没有遥测数据

遥测默认关闭。先调用 wpx01a_start_telemetry，等待设备返回样本，再读取 latest 或 history。

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

采集默认不启动。调用 wpxs1_start_capture 后检查 capture status 和 stream info；暂停状态使用 wpxs1_resume_capture。

关闭状态窗口后连接中断

这是预期行为。状态窗口负责本地服务和设备连接，关闭后 AI 客户端不能继续操作硬件。重新进入 AI MCP 模式并复制新配置。