从 0 到 1 构建 MCP 插件：一场直播讲透开发、部署与变现全流程
2025 年 11 月 25 日晚，WaytoAGI 社区邀请前世界 500 强企业 IT PM、AI agent 开发者志雄，以及上一期分享过 Python 开发路线的何阳，围绕「MCP 插件召集令插件开发大赛」做了一场保姆级攻略直播。志雄用通义灵码基于 FastMCP 框架，现场演示了从环境准备、Demo 开发、打包验证到一键部署上架蚂蚁百宝箱的完整链路；何阳则补完了上次未完成的虚拟试衣场景演示，并分享了付费 API 的接入与成本规避思路。无论你是想参赛拿奖、还是想系统入门 MCP 开发，这篇文章都能帮你把整条流程装进脑子里。
前期准备：三个必备条件
志雄把构建 MCP 产品的过程分为四个部分：前期准备、Demo 开发、正式开发和技巧分享。其中前期准备是后续一切的基础，他特别强调要提前规避一个容易忽视的坑。
第一，安装 Node.js 环境。 本次采用 Node.js 开发路线，版本必须小于 V 22.21.0。志雄解释了这个限制的来源：“云部署使用的 nodejs 的版本等于 22.21.0，高于此版本的 NPM 包暂时不支持。”因为本次部署走的是阿里百宝箱的一键部署，需要遵循官方要求，提前把版本限定好，能避免后续流程卡壳。
第二，安装通义灵码。 推荐使用通义灵码作为开发工具，它支持独立 IDE 和插件两种形态，可以在 VS Code、Visual Studio 等编辑器中使用。志雄也说明这不是强制要求：“本质上这就是一个 Web coding，我们就是用自然语言的方式去进行此次项目开发，所以大家根据自己的习惯来。”
第三，注册 NPM 账号。 这一步很多人会忽略，但它是部署链路里的关键环节。百宝箱的一键部署通过 NPX 方式拉取代码，所以开发好的 MCP 代码需要先打包发布到 NPM 仓库，再由百宝箱从云端下载使用。注册门槛不高，“用国内的邮箱就可以注册了，比如说我就用 QQ 邮箱尝试注册也是可以成功的。”
Demo 开发：五步跑通全流程
志雄把 Demo 开发拆成五步：开发代码、打包 MCP、验证功能、发布到百宝箱、在百宝箱平台构建应用智能体引用 MCP。完成这五步，就等于从 0 到 1 完成了一次 MCP 构建。
第一步，安装 FastMCP 框架。 在通义灵码中新建一个空文件夹并用灵码打开，在对话框里选择「智能体」模式（志雄特别提醒：“智能体的效果明显要比对话要好很多，另外智能体才可以帮你去执行相关的命令跟操作”），然后粘贴安装命令。灵码会自动在终端执行 npm install，下载完成后左侧资源管理器会出现 node_modules 文件夹和两个 json 文件，即表示安装成功。
第二步，用自然语言创建工具。 在对话框里输入需求描述，例如：“基于 fast MCP 框架构建一个 hello fast MCP 工具，无输入参数，输出文本为 hello fast MCP。”灵码会自行阅读框架文档、生成代码。过程中需要留意两处授权：代码视图区的「采纳/拒绝」按钮，以及右下角的变更文件提示。志雄提醒，灵码不是一次就能写对的，“它也在尝试性地做出一些决策之后去进行验证，然后发现有问题，然后再进一步做出新的决策”，如果发现它在原地打转，可以手动停止让它重来。
第三步，打包并生成 MCP Server 配置文件。 代码开发完成后，让灵码生成 MCP Server 配置文件——就是平时在其他 AI 工具里引用 MCP 时粘贴的那段 JSON。志雄解释了这个文件的作用：“我们经常要想引用 MCP 的时候会输入一串那个 json 文本，那个文本的内容其实就是指这里的 MCP Server 的配置文件。”
第四步，发布到 NPM。 在终端执行发布命令。首次使用需要先登录 NPM 账号，登录有效期内后续只需直接发布。发布成功后可以在 NPM 个人账号下看到刚上传的代码包。
第五步，本地验证。 在灵码设置中找到 MCP 服务，添加服务并粘贴配置文件内容。如果连接报错，可以直接把错误信息选中，点击「添加到对话」，用场景化描述让灵码修复。志雄分享了一个提示词技巧：“我告诉他是什么情况下，当我以 NPX 的方式将 MCP 导入到其他 AI 工具时出现了这个错误……让他去进行修复，而不是直接把错误信息抛给他。”验证成功的标志是 MCP 服务显示为绿色的链接图标，此时在新会话里用自然语言让智能体调用该工具，就能看到输出结果。
发布到百宝箱：从插件到应用
本地验证通过后，进入蚂蚁百宝箱平台。登录后点击「插件」→「新建插件」，选择「创建 MCP 服务」，填写插件名称和描述，安装方式选择「百宝箱一键部署 MCP」（即 NPX 方式），把 MCP Server 配置字符串粘贴进去，点击确认后等待加载。志雄特别提醒参赛者：“图标记得更换一下，不能用默认的，为了参加这次比赛的话，一定要自己更换一下。”
插件创建后处于「未调试」状态，需要先调试功能。展开工具列表点击调试，由于 hello fast MCP 没有输入参数，直接点击运行，响应中会输出 hello fast MCP，调试状态变为「调试通过」后即可点击发布。
插件发布后，还需要在工作空间的应用中创建一个应用。新建应用后进入智能体编排页面，在插件模块点击添加，把刚发布的插件引入。志雄强调：“只有发布完成之后的这个应用，我们才能够参加这次的比赛，因为比赛是需要去提供这个发布之后的应用的链接的。”最终在比赛链接里提交作品信息即可。
正式开发：从 Demo 到场景化产品
跑通 Demo 之后，真正的挑战在于如何开发一个有实际价值的 MCP。志雄认为，MCP 的价值不在于做一个简单的输入输出插件，而在于“连接更复杂的或者是多个接口的、或者是多个大模型的处理，有点类似于是一个工作流在一个 MCP 里面去完成，它完成的是一个场景化的交付”。
他以企业差旅报销为例：传统流程中，发票审核需要人工比对，后来有了 RPA 和 OCR 技术，但仍是多层链路。而通过 MCP，可以把多个环节整合到一起——传入申请表单和附件，由视觉大模型读取发票信息，再用另一个大模型读取表单信息，两者做关键字匹配，直接输出审核意见。这才是 MCP 真正的用武之地。
志雄建议，正式开发时可以从官方参考场景入手，由简单到复杂逐步递增，先做一个 MVP 产品跑通流程。他随后以自己开发的「发票识别助手」为例，拆解了开发思路：
- 定义输入、功能、输出：输入是多张图片的 URL，功能是调用大模型识别图片信息，输出是指定格式的 JSON 字符串。
- 准备大模型：在阿里百炼创建 API key，在大模型广场测试提示词，验证技术路线可行。
- 获取 API 参考代码：在官方文档中复制接口调用示例（curl 或 Node.js 版本），连同提示词、API key 一起放到项目文件夹中。
- 在灵码中开发：点击「添加上下文」引用准备好的文件，然后用自然语言描述需求，让灵码生成代码。后续的打包、验证、发布流程与 Demo 完全一致。
志雄还分享了一个迭代技巧：代码更新后不需要重新创建插件，在百宝箱插件页面点击「获取更新」，它会重新拉取 NPM 中的最新代码，可以选择替换或新增。但前提是“项目名称没有变的情况下，千万不要去改项目名称，特别是配置文件里面的名称”，因为百宝箱依赖 NPX 命令中的参数来定位代码包。
虚拟试衣实战：付费 API 的接入与成本规避
何阳接着补完了上次直播未完成的虚拟试衣场景演示。整个场景只用了一个 FastMCP 框架，核心提示词是：使用 fast m MCP 框架生成一个虚拟试衣能力的 MCP 服务，用户只需上传衣服图片和模特图片的 URL，即可将衣服穿在模特身上，输出换装前后的图片。
把提示词粘贴到灵码的智能体模式后，代码很快生成。安装依赖、运行程序，遇到错误就把错误信息贴回对话框让灵码修复。服务启动后，把测试链接贴到浏览器，将 IP 改为本机地址即可访问。何阳推荐使用官方推荐的 MCP 验证工具，选择 streamable HTTP 协议，填入 MCP 地址连接，然后在 tools 列表中找到虚拟试衣服务，填入模特图片和服装图片的 URL 运行。
何阳解释了核心原理：“核心用的是一个即梦 4.0 的图生图的能力……它需要传两张图，然后说将图一的服装换为图二的服装。核心的话它就是这个 API，只不过是咱们使用了一个 Faas 的 MCP 的 Python 框架，去把这个 API 重新包装了一下，包装成了一个 MCP 的 tool。”
针对付费 API 的成本问题，何阳给出了一个实用方案：把 API key 作为入参暴露给用户。“如果还是继续使用咱们自己的 key 的话，别人用一次就会从咱们的钱包里边扣一次钱，因为这图片一次是两毛钱，所以我把它当成入参暴露出来了，让用户去填，这样的话他就直接会扣用户他模型账户里的钱。”改造完成后，工具参数从两个变为三个（模特图片、服装图片、API key），即表示发布成功。
何阳还对比了两种部署方式：百宝箱一键部署对新手友好，不需要准备服务器，但只支持 NPM 方式（即 Node.js 开发）；自部署则需要自己准备服务器、安装依赖、开放端口，“这一步的话会卡住很多人”。他建议参赛者优先选择 Node.js 的一键部署路线。
现场问答
问：百宝箱不能部署 Python 包吗？
答：MCP 有两种部署模式。一键部署 MCP 只支持 NPM 方式，通过 Node.js 开发后发布到中央仓库，不需要服务器；自部署则需要自己准备服务器，把程序部署在服务器上，通过自部署方式接入。自部署门槛较高，需要了解服务器环境、依赖安装、端口开放等。
问：付费 API 的 key 暴露出去后，base URL 是通用的吗？
答：base URL 应该是通用的，具体可以查看即梦的 API 文档。
问：后续 MCP 服务如何商业变现？
答：百宝箱后续会与开发者协商定价模式，2026 年将推出自定义定价功能，开发者可以通过 MCP 服务实现商业变现。百宝箱希望引入有商业价值的插件，开发者可以开发相关服务参与商业变现。
要点回顾
- 前期准备三件事：安装 Node.js（版本小于 V 22.21.0）、安装通义灵码、注册 NPM 账号。
- Demo 开发五步走：开发代码 → 打包 MCP → 本地验证 → 发布到百宝箱 → 构建应用引用 MCP。
- 开发工具用智能体模式：通义灵码的智能体模式效果明显优于普通对话，且能自动执行命令。
- 遇到 bug 别死磕：灵码有概率性，如果长时间卡住，删掉重来可能更快。
- 正式开发先想清楚：输入是什么、功能怎么处理、输出是什么，想清楚再让 AI 写代码。
- 付费 API 成本规避：把 API key 作为入参暴露给用户，让用户用自己的 key，避免扣自己的费用。
- 部署方式选择：新手优先用百宝箱一键部署（Node.js + NPM），自部署门槛较高。
- 参赛提交注意：只有发布完成后的应用才能参赛，记得更换插件图标，提交时需提供体验链接。
直播回放约 146 分钟
播放器来自飞书妙记 · 在新窗口打开