Releasing the npm package
@muninn-org/aether-mcp lets people install aether-mcp globally with npm install -g, or run it once with npx.
The package is a small launcher in npm/aether-mcp/. It downloads the matching aether-mcp release binary from GitHub Releases, checks its SHA-256 checksum, and runs it.
It is published by CI, and only when the release branch is updated.
A push to main never publishes.
Release steps
-
Cut an
aether-mcprelease by pushing avX.Y.Ztag. Wait for the release workflow to finish. The release must contain an archive and a checksum for every supported platform. -
Open a pull request that sets
aetherMcpVersioninnpm/aether-mcp/package.jsonto that version. Bump the packageversiontoo, because npm never accepts the same version twice. -
Merge it, then publish by moving the
releasebranch to the commit you want:git push origin <commit>:release -
Watch the Publish npm package workflow. It runs the launcher tests on Linux, macOS, and Windows, checks that the release has every build, and publishes with provenance.
If the package version is already on npm, the workflow publishes nothing. If the release is missing a build, the workflow fails before publishing.
One-time setup
- The package is published under the
muninn-orgorganization on npm, so its name is@muninn-org/aether-mcp. The publishing account must be a member that can publish to it. - Create an npm access token that can publish
@muninn-org/aether-mcpand save it as the repository secretNPM_TOKEN. If the npm account requires a one-time code to publish, the token must be allowed to bypass that, or the publish step fails in CI. - Optional: add required reviewers to the
npmenvironment in the repository settings, so each publish needs an approval. - Optional: protect the
releasebranch so only maintainers can push to it.
Settings users can change
| Environment variable | Purpose |
|---|---|
AETHER_MCP_VERSION | Use a different aether-mcp release than the one the package was tested with |
AETHER_MCP_CACHE_DIR | Where downloaded binaries are kept |
AETHER_MCP_DOWNLOAD_BASE | Download releases from a mirror instead of GitHub |