写出来不难，分发出去才算数
上一节写了第一个插件。但如果它只躺在你电脑里，价值就大打折扣。这一节讲打包、发布、分发——让团队真正装得上、用得上。
分发的核心目标是：别人一条命令就能装上，装上就能用，用着还一致。
对 mcp-hub 来说，这一点尤其关键：它的价值不是「你自己能用」，而是**「团队每个人都能装上同一套 MCP 接入能力」**。不做好打包发布，mcp-hub 就只是你桌面上一个没人知道的文件夹。
打包：让插件可携带
插件开发完，要整理成可分发的形式。关键点：
- 清单：一份清单说明插件的名字、版本、作用
- 内容：把插件涉及的描述、指令、配置打包进去
- 依赖：声明它依赖什么（Node 版本、外部工具等）
打包的目的，是让「一份插件 = 一套自洽的东西」，别人拿到就能用。
mcp-hub 的清单至少该写清：
name: mcp-hub
version: 0.1.0
description: 集中接入、校验、分发团队的 MCP 服务
commands:
- mcp-hub add
- mcp-hub list
- mcp-hub validate
dependencies:
- node: ">=18"
- claude-code: ">=1.x"
清单是别人决定「要不要装、装了什么」的第一份说明书，值得写清楚。
发布：给插件一个「可安装」的入口
发布后，团队成员应该能通过一个明确的入口安装它。常见的形态：
- 内置仓库分发：放进团队的插件/技能仓库，clone 即得
- 包/清单分发：通过插件清单安装
核心是：安装路径要明确、可重复，而不是「某个人手动拷目录」。
对 mcp-hub 最实际的发布方式，是放进团队共享仓库，并在 README 里给出一条安装命令。别人不用知道你内部结构，照着命令跑就行。
分发：三种典型场景
| 场景 | 做法 |
|---|---|
| 个人 | 放自己配置目录，自己用 |
| 团队 | 放团队仓库，全员 clone 即用 |
| 更广范围 | 打包发布，别人可安装 |
从个人 → 团队 → 更广，分发的「规范化」要求逐级提高。
mcp-hub 的目标是至少做到「团队」这一档：放进仓库、全员 clone 即用。等你把团队这一档跑顺了，未来要对外发布也就是顺水推舟。
分发后要解决的三个坑
1. 行为不一致
同一插件在不同人电脑上表现不同。排查：锁版本、写清依赖和运行环境，别依赖机器特定的东西。
对 mcp-hub：服务清单的格式和存放路径必须统一——如果 A 把它放在 ~/.mcp-hub/、B 放在项目里的 .claude/，两个人的 mcp-hub list 看到的东西就对不上。规定一个目录，写进文档，全员照做。
2. 版本混乱
插件更新了，但有人还在用旧版。排查：版本号要明确，变更走版本控制，别静默覆盖。
对 mcp-hub：每次接入规则变了，就 bump 一版版本号，让成员能看出「自己装的版本够不够新」。
3. 没人维护
发布出去没人管，慢慢失效。排查：明确负责人，跟随实践迭代。
一个发布检查清单
发布前过一遍：
- [ ] 清单里写清了名字、版本、作用？
- [ ] 依赖和环境要求说明了？
- [ ] 安装方式明确了（一条命令/一个入口）？
- [ ] 版本号有意义，变更可追溯？
- [ ] 有负责人维护？
落地练习：把 mcp-hub 发布进团队仓库
这一节，把 mcp-hub 从「本地目录」推进成「团队可装」。
跟着这三步走：
- 给 mcp-hub 建一份清单（参考上面的 yaml），把名字、版本、命令、依赖写清楚
- 把 mcp-hub 放进一个共享 Git 仓库，并在 README 写出一条安装命令（比如
git clone+ 复制到配置目录） - 按「发布检查清单」逐项打勾，缺哪项补哪项
你会怎么判断做对了？——让一个完全没碰过 mcp-hub 的同事，只看 README 就能装起来，并且装完后
mcp-hub list的行为和你一致，就算过关。
卡住了怎么办？ 没有团队仓库？先用你自己的一个 GitHub/Gitee 空仓库模拟。README 不会写？直接让 Claude Code 帮你生成，你再改。清单字段不确定？以你所用 Claude Code 版本的文档为准，核心是把「版本、命令、依赖」三样写上。
常见坑：发布后从不回访，插件慢慢「烂」掉
一个很真实的坑：插件发布当天很兴奋，之后半年没人看。等哪天有新人来装，装上一跑全是错的——因为服务清单格式变了、某个 MCP 服务下线了，而插件没人更新。
发布不是终点，是维护的开始。 mcp-hub 尤其要警惕：团队规模一大，各种服务的地址、凭据、协议版本都会变。给它定个「维护节奏」——哪怕每月只花半天过一遍服务清单、核一遍版本，就能避免「发布即腐烂」。
小结
- 分发的核心：别人一条命令装上、装上能用、用着一致
- 打包 = 让插件自洽可携带；发布 = 给可安装入口
- 分发场景：个人 / 团队 / 更广，规范化逐级提高
- 防三坑：行为不一致、版本混乱、没人维护
- mcp-hub 至少要做到「团队 clone 即用」，并有维护节奏
下一模块进入 MCP 服务集成。