Skip to content

Commit 27d948a

Browse files
Add publish checklist
1 parent f12304b commit 27d948a

1 file changed

Lines changed: 164 additions & 0 deletions

File tree

PUBLISH_CHECKLIST.md

Lines changed: 164 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,164 @@
1+
# 🚀 MCP Git Enhanced - 发布检查清单
2+
3+
## 发布状态
4+
5+
| 步骤 | 状态 | 说明 |
6+
|------|------|------|
7+
| 代码准备 | ✅ 完成 | 已推送到 GitHub |
8+
| npm 发布 | ⏳ 待手动执行 | 需要 npm 登录 |
9+
| MCP Registry 发布 | ⏳ 待手动执行 | 需要 mcp-publisher 登录 |
10+
| 推广 | ⏳ 待手动执行 | Twitter/X 发布 |
11+
12+
---
13+
14+
## 1. npm 发布 (需要手动执行)
15+
16+
### 前提条件
17+
- 需要 npm 账号 (https://www.npmjs.com/)
18+
- 需要双因素认证 (2FA) 的 OTP
19+
20+
### 执行步骤
21+
22+
```bash
23+
# 1. 进入项目目录
24+
cd /home/openclaw/.openclaw/workspace/mcp-git-enhanced
25+
26+
# 2. 登录 npm
27+
npm login
28+
# 或使用网页登录
29+
npm login --auth-type=web
30+
31+
# 3. 构建项目
32+
npm run build
33+
34+
# 4. 运行测试
35+
npm test
36+
37+
# 5. 发布 (公开访问)
38+
npm publish --access public
39+
40+
# 6. 验证发布
41+
npm view @bountyclaw/mcp-git-enhanced
42+
```
43+
44+
### 预期输出
45+
```
46+
+ @bountyclaw/mcp-git-enhanced@1.0.0
47+
```
48+
49+
---
50+
51+
## 2. MCP Registry 发布
52+
53+
### 前提条件
54+
- npm 包已发布
55+
- GitHub 账号已登录
56+
57+
### 执行步骤
58+
59+
```bash
60+
# 1. 进入项目目录
61+
cd /home/openclaw/.openclaw/workspace/mcp-git-enhanced
62+
63+
# 2. 登录 MCP Registry (使用 GitHub 认证)
64+
mcp-publisher login github
65+
66+
# 3. 按照提示完成设备授权流程
67+
# - 访问 https://github.com/login/device
68+
# - 输入终端显示的代码
69+
# - 授权应用
70+
71+
# 4. 发布到 MCP Registry
72+
mcp-publisher publish
73+
74+
# 5. 验证发布
75+
curl "https://registry.modelcontextprotocol.io/v0.1/servers?search=io.github.davidweb3-ctrl/mcp-git-enhanced"
76+
```
77+
78+
### 预期输出
79+
```
80+
Publishing to https://registry.modelcontextprotocol.io...
81+
✓ Successfully published
82+
✓ Server io.github.davidweb3-ctrl/mcp-git-enhanced version 1.0.0
83+
```
84+
85+
---
86+
87+
## 3. 推广
88+
89+
### Twitter/X 发布内容模板
90+
91+
```
92+
🚀 刚刚发布了 MCP Git Enhanced - 一个增强型 Git MCP 服务器!
93+
94+
✨ 功能亮点:
95+
• 代码差异分析 (git_diff)
96+
• 提交历史分析 (git_log)
97+
• 分支管理 (git_branch)
98+
• 仓库状态 (git_status)
99+
• 提交详情分析 (git_commit_analyze)
100+
101+
📦 npm: npm install -g @bountyclaw/mcp-git-enhanced
102+
🔧 MCP Registry: io.github.davidweb3-ctrl/mcp-git-enhanced
103+
📖 GitHub: https://github.com/davidweb3-ctrl/mcp-git-enhanced
104+
105+
#MCP #Git #DeveloperTools #AI
106+
```
107+
108+
### 开发者社区分享
109+
110+
- [ ] Reddit r/programming
111+
- [ ] Hacker News (Show HN)
112+
- [ ] Dev.to 文章
113+
- [ ] GitHub Discussions
114+
115+
---
116+
117+
## 项目信息
118+
119+
| 属性 ||
120+
|------|-----|
121+
| 包名 | @bountyclaw/mcp-git-enhanced |
122+
| 版本 | 1.0.0 |
123+
| MCP Registry 名称 | io.github.davidweb3-ctrl/mcp-git-enhanced |
124+
| GitHub 仓库 | https://github.com/davidweb3-ctrl/mcp-git-enhanced |
125+
| 测试覆盖率 | 98% |
126+
| 测试数量 | 43 个 |
127+
128+
---
129+
130+
## 故障排除
131+
132+
### npm 发布失败
133+
134+
| 错误 | 解决方案 |
135+
|------|----------|
136+
| ENEEDAUTH | 运行 `npm login` 登录 |
137+
| E403 | 检查包名是否已被占用 |
138+
| EOTP | 输入双因素认证 OTP |
139+
140+
### MCP Registry 发布失败
141+
142+
| 错误 | 解决方案 |
143+
|------|----------|
144+
| "Registry validation failed for package" | 确保 package.json 包含 `mcpName` 字段 |
145+
| "Invalid or expired Registry JWT token" | 重新运行 `mcp-publisher login github` |
146+
| "You do not have permission to publish this server" | 确保 mcpName 格式为 `io.github.your-username/...` |
147+
148+
---
149+
150+
## 后续维护
151+
152+
### 版本更新流程
153+
154+
1. 更新代码
155+
2. 修改版本号:`npm version patch|minor|major`
156+
3. 提交并推送:`git push && git push --tags`
157+
4. 发布到 npm:`npm publish --access public`
158+
5. 更新 MCP Registry:`mcp-publisher publish`
159+
160+
### 监控指标
161+
162+
- npm 下载量: https://www.npmjs.com/package/@bountyclaw/mcp-git-enhanced
163+
- MCP Registry 状态: https://registry.modelcontextprotocol.io
164+
- GitHub Stars: https://github.com/davidweb3-ctrl/mcp-git-enhanced

0 commit comments

Comments
 (0)