本机 AI 自动化

2.3 起，WPE 可以把它 已有的功能 交给本机上支持 MCP 的 AI 客户端调用：查封包、看日志、写滤镜、建账号、跑发送与机器人……都能用对话完成。这一章讲清楚 WPE 这一侧怎么开、状态怎么看、能读能写什么，以及该注意什么。

01 · 这是什么

MCP（Model Context Protocol，模型上下文协议）是 AI 客户端与本机程序之间的一套通用接口。WPE 2.3 实现的是它的 服务端：把 WPE 自己的功能包装成一个个带名字的「工具」，AI 客户端连上来之后就能调用它们 —— 你不再需要点菜单，直接说「把这条封包的第三个字节改成 0x10 再发一遍」就行。

• 它是本机的：服务跟着 WPE 跑在这一台电脑上，只服务 当前这个 Windows 用户，不联网、不需要账号。
• WPE 必须先运行：连接器只是替你在 WPE 里按按钮，它不会去启动任何东西。WPE 一关，AI 客户端就会报告服务离线。
• WPE 是唯一的数据源：所有读写都走 WPE 自己的入口 —— AI 客户端不会绕过它直接改你的配置文件与数据库。
• 谁来用：就是你自己。谁运行着 WPE，谁就能通过 MCP 操作它，所以这台机器得是你自己的、可信的。

02 · MCP 设置

入口在 首页 第二条窄行（那条写着 MCP 的），右端写着当前可用的 工具数；点开是与其它设置一致的 分区弹窗，只有两个开关加一张工具清单。

下面的 MCP 工具列表 就是当前实际注册的全部工具（2.3 是 125 个），按 代理 / 注入 / 封包 / 滤镜 / 发送 / 机器人 / 仓库 / 设置 / 其它 分组排列，每一项写着工具名与一句说明 —— 这份清单与 AI 客户端里看到的工具是一一对应的。写操作会按上面那个确认开关的状态在清单下方标出来。本教程把这份清单也抄了一份在网页上，见 第 9 章 · MCP 工具速查。

03 · 状态与日志

• MCP 状态灯（底部状态栏右端，紧跟代理状态之后）：灰 = MCP 服务已关闭；黄 = 运行中，写入需要你人工确认；绿 = 运行中，写入可自动执行。一颗灯就能看出「现在是哪种状态」
• MCP 日志（代理 / 注入模式 → 系统日志 的第四个页签，见 工具章 07 节）：记下每一次工具调用、写入审计结论与出错原因。「模块」那一列写的就是工具名，所以想追溯「刚才 AI 到底动了什么」，翻这一页最直接

04 · 接入 AI 客户端

WPE 的发布包里带了一个 自包含 的连接器 WPEMcpServer.exe（不需要另装运行库）。启动器每次启动都会把它同步到固定路径：

C:\WPE64DB\McpServer\WPEMcpServer.exe

1. 在 AI 客户端的 MCP 配置里新增一个 stdio 服务，命令填上面这个路径（客户端要求写完整命令行时，只填这一个 exe 即可，不带参数）。
2. 保持 WPE 正在运行，让客户端连一次：它会自动发现当前用户下正在运行的 WPE 实例，然后把工具清单拉出来。
3. 关掉 WPE 后客户端会报告服务离线；下次 WPE 起来再连一次即可，配置不用改。

以 VS Code 为例

VS Code 把 MCP 做进了 GitHub Copilot Chat —— MCP 服务是通过 Copilot 的 agent 模式使用的，所以先装好 Copilot 扩展并登录（Copilot 不可用时，配置里的服务不会被启动），再按下面三步把 WPE 接进来。

1. 打开配置文件：命令面板（Ctrl+Shift+P）里运行 MCP: Open User Configuration —— 这是 用户级 配置，配一次所有工作区都能用；只想给某个项目用，就打开那个项目的 .vscode/mcp.json。也可以直接运行 MCP: Add Server，按引导选 Workspace 或 Global，它会替你写好下面这段。
2. 写入这一段。注意 Windows 路径里的反斜杠要写成两个；这个文件有补全与校验，键名拼错会当场提示：
   mcp.jsonCOPY

   { "servers": { "wpe": { "type": "stdio", "command": "C:\\WPE64DB\\McpServer\\WPEMcpServer.exe" } }}
3. 启动并信任：保存后配置里会出现 Start 链接，点它；第一次启动 VS Code 会弹一次信任确认，确认之后它就去发现工具，并把它们挂进 Chat。工具清单变了（例如换了 WPE 版本）可以运行 MCP: Reset Cached Tools 清缓存。

之后打开 Chat 视图（Ctrl+Alt+I）、切到 agent 模式，直接用自然语言下指令即可 —— 比如「把当前封包列表读出来看看」。聊天输入框旁边的 Configure Tools 按钮能列出 WPE 的全部工具，也可以逐个启用 / 停用。

05 · 能做什么

工具分成只读与写入两类。只读工具用来 看，写入工具用来 改 —— 后者受「MCP 操作需要人工确认」管。

• 启动页上多一件事：停在首页没进任何模式时，AI 可以替你 选进代理模式或注入模式。这只是在两个模式之间做选择，不会启动代理监听、也不会注入；一旦你离开了首页，这个能力就失效（重复选当前模式会被告知无需操作）
• 不提供的两件事：任意路径的文件 / 剪贴板读写，以及不经过确认的静默注入 —— 这两条不在开放范围内

06 · 使用建议与排查

MCP 把 WPE 的操作面交给了 AI，所以这几条值得先记住：

• 只在你自己的电脑上开它：服务和发现记录都只对当前这个 Windows 用户可见，同一台机器上别的用户看不到。写完用完把总开关关掉最省心
• 拿不准就留着人工确认：确认开着时，每次写入都会在 WPE 里弹一次确认 —— 相当于把「要不要执行」这一票留在自己手里
• 只读工具给的是完整数据：封包内容、账号密码这些都会原样返回给客户端。所以要接就接你信任的客户端，别接来路不明的服务