课前准备：给 WorkBuddy 接上 MCP
1. 软件与账号
| 准备项 | 必要动作 | 成功标志 |
|---|---|---|
| WorkBuddy 桌面端 | 登录且能新建任务（教师课前核实 MCP 设置入口） | 能找到 MCP / 插件设置入口并点「添加 MCP 服务」 |
| Node.js（含 npx） | 本课首次用到，由教师课前统一安装到机房 | 命令行执行 npx --version 能报出版本号 |
| Python 3.10+ | 由教师课前装到学生机或统一发放离线安装包 | 命令行执行 python --version 能报出 3.10 以上版本 |
| fastmcp 框架 | 由教师课前随 Python 一起装好 | 命令行执行 pip show fastmcp 能看到包信息 |
| 文本编辑器 | 系统自带记事本即可 | 双击 txt 能正常打开 |
不同版本入口由教师课前核对：[课前演练补充]。课前未确认的项目先找老师处理，不在课内临时安装。
WorkBuddy 还没安装或没登录过的同学：打开官网 https://www.workbuddy.cn/ 下载 Windows 版，双击安装包按默认选项安装，然后注册并登录。详细图文步骤见第 07 课讲义《WorkBuddy 安装、设置与第一个任务》的 M1 环节。
2. 建本课目录
- 双击「此电脑 → D盘」，空白处右键「新建 → 文件夹」，建 AIGC；进入后同样建立 lesson-12，得到 D:\AIGC\lesson-12。
- 本课的
素材库、study-log两个子文件夹在课内按讲义步骤创建，课前只建本课目录即可。
3. 课前自查
| 查什么 | 成功标志 |
|---|---|
| 本课目录 | 已建立 D:\AIGC\lesson-12 |
| WorkBuddy 可用 | 能新建任务，能找到 MCP / 插件设置入口 |
| npx 可用 | npx --version 报出版本号（案例1–3 依赖） |
| Python 可用 | python --version 报出 3.10 以上（案例4 依赖） |
| fastmcp 已装 | pip show fastmcp 能看到 Name、Version 两行 |
自查用的命令在哪个窗口执行：资源管理器进入任意文件夹，点地址栏输入 cmd 回车；或在开始菜单搜「命令提示符」直接打开。
4. 常见故障
npx不是内部命令：Node.js 没装到位，举手找老师按机房离线包重装，不要自己上网乱下。python不是内部命令：教师课前安装未覆盖本机，举手登记，由老师现场装或换机。pip show fastmcp无结果：找老师补装，课堂内安装走机房内网源，不用公网慢速下载。- 账号或权限问题：课前请老师确认机房账号与目录权限，不把重装软件当排错第一步。
5. 教师课前实测
以下操作需要在实际机房电脑执行；环境自查通过不代表这些步骤已经验证。
| 实测项目 | 通过标志 |
|---|---|
| npx 包预下载 | filesystem、memory、12306-mcp 三个包在教师机预拉取成功，机房缓存可用 |
| MCP 入口核对 | WorkBuddy 的 MCP / 插件设置入口与讲义配置 JSON 格式一致，能添加 stdio 服务 |
| 案例1–3 实演 | 三个现成 MCP 服务器按讲义配置逐个连接成功，13 分钟内可完成 |
| 案例4 实演 | pip install fastmcp、python server.py、WorkBuddy 添加 study-log 全流程可跑通，打卡写入 records.json |
| 12306 可用性 | 12306-mcp 包可正常安装并返回真实车次；不可用时确定替代包或改为演示案例 |
实测记录写入教师侧「备课设计与审查.md」，注明电脑环境、结果和耗时。实测未通过的项目按讲义内的兜底路径执行。