You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/release-runbook.md
+18-7Lines changed: 18 additions & 7 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -32,13 +32,11 @@ chore(release): bump workspace versions to 0.2.0
32
32
33
33
### 1. Bump versions
34
34
35
-
Update the version in all four package manifests and the MCPB `manifest.json`:
35
+
```bash
36
+
node scripts/bump_version.mjs <version>
37
+
```
36
38
37
-
-`packages/docx-core/package.json`
38
-
-`packages/docx-mcp/package.json`
39
-
-`packages/safe-docx/package.json`
40
-
-`packages/safe-docx-mcpb/package.json`
41
-
-`packages/safe-docx-mcpb/manifest.json`
39
+
This script is the source of truth for which files are managed (package manifests, MCPB manifest, cross-workspace dependency ranges, and `package-lock.json`). Do not bump versions manually.
42
40
43
41
Commit: `chore(release): bump workspace versions to X.Y.Z`
-[ ]`node scripts/bump_version.mjs --check` confirms all managed files are in sync
68
67
-[ ] npm packages are published with provenance
69
68
-[ ] GitHub Release exists with categorized notes
70
69
-[ ] MCPB asset is attached to the release
71
70
-[ ] Changelog data PR is opened (merge it to update the trust site)
72
71
72
+
### 5. MCP Registry Submissions
73
+
74
+
After npm publish, submit the package to each registry target:
75
+
76
+
1.**Official MCP Registry** (`registry.modelcontextprotocol.io`) — Requires `packages/safe-docx/server.json` (already managed by the bump script). Submit via the [registry quickstart](https://modelcontextprotocol.io/registry/quickstart).
77
+
2.**Anthropic Connectors Directory** — Separate from the official registry. Submit local MCP servers via the [Google Form](https://support.claude.com/en/articles/12922832-local-mcp-server-submission-guide).
78
+
3.**mcpservers.org** — Manual web form at https://mcpservers.org/submit.
79
+
4.**Smithery.ai** — Publish via https://smithery.ai/docs/build/publish or https://smithery.ai/new.
80
+
5.**Glama.ai** — Auto-discovers from GitHub/registry. Verify listing after registry publish + sync window (not tied to npm timing).
81
+
82
+
> **Note:** These URLs were verified as of 2026-03-17. Confirm they are still current at submission time.
83
+
73
84
## Monorepo Version Coupling
74
85
75
-
All publishable packages share the same version. The preflight job verifies that the tag version matches every `package.json` and the MCPB `manifest.json`. If any mismatch exists, the release fails before publishing.
86
+
All publishable packages share the same version. The preflight job verifies that the tag version matches all files managed by `bump_version.mjs`. If any mismatch exists, the release fails before publishing.
0 commit comments