anselmoo/Build .mcpb bundle
Build .mcpb bundles from PyPI/npm MCP servers for one-click Claude Desktop install. Supports complete and reference modes.
View on GitHubTrust Signals
- Scorecard Score
- not yet scored
- Maintenance Recency
- Stale
- License
- None
Inputs
| name | description | required | default |
|---|---|---|---|
| package | Package name on PyPI or npm (e.g. mcp-server-fetch or @modelcontextprotocol/server-github). | yes | — |
| registry | 'pypi' or 'npm' | no | pypi |
| version | Exact version to bundle. Defaults to the current release tag with the leading 'v' stripped (e.g. tag 'v1.2.0' → version '1.2.0'). | no | "" |
| mode | Bundle mode: 'complete' vendors all dependencies into the bundle (recommended; zero runtime deps for the end user). 'reference' produces a lightweight manifest that calls uvx or npx at runtime. | no | complete |
| python-version | Python version used when vendoring Python dependencies. Affects which platform wheels pip selects. Must match the target users' Python version. | no | 3.12 |
| output-dir | Directory where .mcpb files are written. | no | dist |
| runner | Launch runner: 'uvx' | 'npx' | 'uv-run' | 'python' | 'node'. Leave empty to infer from the registry and mode. | no | "" |
| entry-script | Console script (PyPI) / bin name (npm) to launch. Leave empty to auto-detect from the package. | no | "" |
| extras | Space-separated package extras to include (PyPI/uv only), e.g. 'mcp'. | no | "" |
| subcommand | Arguments appended after the entry script, e.g. 'start-mcp-server'. | no | "" |
| transport | Transport flag: 'stdio' | 'none' | 'auto'. Leave empty for auto. | no | "" |
| no-probe | Set 'true' to disable the --help auto-detection probe (offline or deterministic CI). | no | false |
| from-dist | Path to a locally-built artifact (wheel / npm '.tgz', or a directory containing one). When set, the bundle is built from it and the registry is NOT contacted for the package; 'registry' still selects the runtime target (uvx/npx). Skips the --help probe. Omit to fetch from the registry. | no | "" |
| attach-to-release | When 'true' and the workflow was triggered by a 'release' event, attach the .mcpb files to the GitHub Release automatically. | no | true |
| mcp2mcpb-src | Install source for mcp2mcpb (e.g. package spec or local path). | no | mcp2mcpb>=0.5 |
Outputs
| name | description |
|---|---|
| mcpb-files | Newline-separated paths of all produced .mcpb files. |
| version | The resolved version that was bundled. |