本文基于 TapTap 制造官方公告 与个人实际操作整理,记录如何在 WorkBuddy 中接入 Maker MCP,完成 TapTap 制造的本地开发模式初始化。


一、本地开发模式是什么?

根据官方说明,TapTap 制造上线了本地开发模式。简单来说:

  • 有云测试资格:可继续用在线对话/生成/编辑/发布;也可以把 Maker MCP 接入本地 Agent(Codex / Cursor / Claude Code / WorkBuddy 等)。
  • 暂无云测试资格:可以先在本地用熟悉的 AI 工具开发,完成后再回到 TapTap 制造发布项目。

核心思路:本地负责开发,TapTap 制造负责发布。同时官方同步调整了规则:发布不再消耗积分


二、准备工作

  • 一台已安装 Node.js 的电脑(npx 可用)。
  • 已安装 WorkBuddy(或其他支持 MCP 的 Agent)。
  • 一个空白的本地目录,用于作为项目目录。

三、第一步:安装并配置 Maker MCP

在 WorkBuddy 输入安装命令:

npx -y @taptap/maker install --ide Workbuddy

--ide 后面可以跟 codexcursorclaude 等,这里我用的是 Workbuddy

在这里插入图片描述

命令执行后,WorkBuddy 会提示配置已写入 ~/.workbuddy/mcp.json,但此时 MCP 还处于未信任状态,需要手动启用。

在这里插入图片描述


四、第二步:在 WorkBuddy 中启用 taptap-maker

  1. 点击左侧「专家·技能·连接器」→ 切换到「连接器」标签页。
  2. 点击右上角「自定义连接器」。

在这里插入图片描述

  1. 在 MCP 服务管理中找到 taptap-maker,打开右侧开关即可启用。

在这里插入图片描述

启用后建议重连或重启 WorkBuddy,让 MCP 生效。


五、第三步:初始化项目

选择一个空白目录,在 WorkBuddy 中执行:

npx -y @taptap/maker init

在这里插入图片描述

init交互式命令,运行后会提示你选择:

  • 关联已有的 Maker 应用;
  • 或者创建新项目。

在这里插入图片描述

由于我这里是本地新建,选择「创建新项目」,然后输入项目名。例如我选了 idle-clicker

在这里插入图片描述


六、第四步:项目初始化完成

命令执行完成后,WorkBuddy 会输出项目信息,例如:

  • 新建项目:idle-clicker
  • App ID:f05af2db-9743-4aa7-82f4-c0a1f554cca1
  • 项目目录:/Volumes/拯救者PSSD/taptap
  • 生成目录:assets / engine-docs / examples / schemas / scripts / templates / tools / urhox-libs
  • 配置目录:.maker / .maker-mcp
  • 辅助文件:AGENTS.md / CLAUDE.md / .gitignore
  • Git 已自动初始化

在这里插入图片描述


七、第五步:检查 MCP 连接状态并修正 cwd

初始化完成后,可以询问 WorkBuddy:

“taptap-maker mcp 连接上了吗?”

WorkBuddy 会反馈当前状态:MCP 已连接,但 MCP 进程的当前工作目录(cwd)没有指向项目目录,导致图片、音频、3D 等生成类工具没有挂载到当前会话。

在这里插入图片描述

此时需要让 WorkBuddy 把 cwd 写入 mcp.json,并重新连接。例如:

"cwd": "D:\taptap"

在这里插入图片描述

完成后,回到 MCP 服务管理页面,对 taptap-maker 点击重连(Reconnect)。

在这里插入图片描述


八、第六步:开始本地开发

当 WorkBuddy 提示以下内容时,说明 MCP 已完全就绪:

  • cwd 对齐
  • 8 个素材生成工具已挂载
  • build / submit 可用
  • 项目 idle-clicker 已绑定到本地目录

在这里插入图片描述

此时你可以让 WorkBuddy 帮你:

  1. 起游戏框架:在 scripts/ 下基于放置/挂机脚手架写最小可跑的 idle 核心(金币、自动产出、升级)。
  2. 试素材流水线:生成游戏图标、UI 贴图或 BGM,验证 assets/ 落盘链路。

九、常见问题与注意事项

问题 原因 解决方法
安装后 MCP 没有工具可用 未信任/启用 taptap-maker 在 WorkBuddy 连接器中手动启用
init 命令直接退出 非交互式运行,没有传入选择 直接交互选择,或参考命令参数传入 --create --name <项目名>
素材生成工具没挂载 MCP 进程的 cwd 不是项目目录 mcp.json 中设置 cwd 并重新连接
本地项目如何发布 本地只负责开发 完成后回到 TapTap 制造,在项目列表中选择项目发布

十、总结

TapTap 制造的本地开发模式,让没有云测试资格的玩家也能先开始做游戏 Demo。整个流程可以概括为:

  1. npx -y @taptap/maker install --ide Workbuddy 安装 MCP
  2. 在 WorkBuddy 中启用并信任 taptap-maker
  3. 空白目录下执行 npx -y @taptap/maker init
  4. 选择「创建新项目」并命名
  5. 检查 MCP 状态,必要时修正 cwd
  6. 开始本地开发,完成后回到 TapTap 制造发布

希望这篇记录对你有帮助,也欢迎在评论区交流你的本地开发体验!


参考链接

Logo

欢迎加入 MCP 技术社区!与志同道合者携手前行,一同解锁 MCP 技术的无限可能!

更多推荐