---
title: "Build an MCPB (Bundled Local MCP Server): review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/skills/anthropic-build-mcpb/
description: "Packages a local stdio MCP server with its runtime and dependencies into a .mcpb zip archive with a manifest.json, so a user can install it without setting up Node or Python."
---

# Build an MCPB (Bundled Local MCP Server): review, setup & limitations · Undominated.ai

> Packages a local stdio MCP server with its runtime and dependencies into a .mcpb zip archive with a manifest.json, so a user can install it without setting up Node or Python.

[← Explore all skills](/skills/)

AI APPLICATION DEVELOPMENT / Anthropic

# Build an MCPB (Bundled Local MCP Server)

Packages a local stdio MCP server with its runtime and dependencies into a .mcpb zip archive with a manifest.json, so a user can install it without setting up Node or Python.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/anthropics/claude-plugins-official/tree/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/skills/build-mcpb)

SOURCE REVIEW

 Reviewed 2026-10-21
 Evidence 4 linked sources
 Publisher Anthropic
 Licence [Apache-2.0 ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/LICENSE)
 Revision 41f32e407b45
 [Read what was—and wasn’t—checked ↓](#review)

“This skill should be used when the user wants to "package an MCP server", "bundle an MCP", "make an MCPB", "ship a local MCP server", "distribute a local MCP", discusses ".mcpb files", mentions bundling a Node or Python runtime with their MCP server, or needs an MCP server that interacts with the local filesystem, desktop apps, or OS and must be installable without the user having Node/Python set up.”

 [Anthropic · upstream description ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/skills/build-mcpb/SKILL.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - It defines an MCPB in the source's own terms: a zip archive holding manifest.json, the server code with its bundled dependencies and an icon, which the host launches as a stdio MCP server, built with npx @anthropic-ai/mcpb pack.
- It states that MCPB enforces no permissions: the manifest has no permissions block, the server runs with full user privileges, and path validation and spawn allowlists are the author's job.

### A good fit for

 - Package a local stdio MCP server that reads local files into a .mcpb archive for Claude Desktop
- Write a manifest.json with user_config fields such as a directory picker or a value marked sensitive for the OS keychain
- Decide whether a server needs MCPB at all or should be a remote HTTP server instead

### Weigh up before choosing

 - Last commit touching plugins/mcp-server-dev/skills/build-mcpb at revision 41f32e40: 2026-04-17 (b00abee2).
- Its example read_file and list_files handlers pass the requested path straight to join(ROOT, path), without the check against escaping ROOT that the same page says is required.
- The SKILL.md calls MCPB the secondary distribution path and points to remote servers for directory listing.
- Native Python extensions such as numpy must be built for each target platform; the skill advises avoiding native dependencies.
- Its init, validate, pack and sign commands all run npx @anthropic-ai/mcpb without a version.
- Security hardening is delegated to references/local-security.md, which the SKILL.md calls mandatory reading.
- build-mcpb is one of three skills in mcp-server-dev, and no file at this revision prints an install line for that plugin.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - plugins/mcp-server-dev/skills/build-mcpb/SKILL.md
- plugins/mcp-server-dev/README.md
- plugins/mcp-server-dev/LICENSE
- README.md

### Our findings

 - The SKILL.md frontmatter declares no allowed-tools; the skill directory holds SKILL.md and two reference files.
- server.type may be node, python or binary; the SKILL.md calls it informational and says the launch comes from server.mcp_config.
- user_config entries are install-time settings shown in the host UI; type directory renders a folder picker and sensitive: true stores the value in the OS keychain.
- Its manifest example targets manifest_version 0.4, claude_desktop >=1.0.0 and the darwin, win32 and linux platforms.

### Not established by this review

 - No bundle was built, validated, signed or installed.
- references/manifest-schema.md and references/local-security.md were not opened.
- Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Add a skill to your workflow.

[Upstream setup instructions ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/README.md)
 - The mcp-server-dev README has a Usage section but no install line, and the repository README only offers the placeholder `/plugin install {plugin-name}@claude-plugins-official`, so install.command is null for build-mcpb.
- The README describes build-mcpb as the skill that packages a local stdio server with its runtime, reached through the build-mcp-server entry skill.
- The bundles it produces are installed by dragging the .mcpb file onto Claude Desktop, per the skill's testing section; that installs the user's server, not this skill.
- Nothing was installed or packed for this review.

### Before you start

 - Claude Code
- Node and npm for npx @anthropic-ai/mcpb; pip for vendoring Python dependencies

### Compatibility

Claude Code

### Guidance for packaging local MCP servers that run with full user privileges

 - No allowed-tools entry in build-mcpb, so commands run with the session's permissions
- Its build steps run npm install, npx esbuild, pip install -t server/vendor -r requirements.txt and npx @anthropic-ai/mcpb pack in the user's project
- A packaged server runs on the user's machine with full user privileges; the SKILL.md says the manifest cannot scope filesystem or network access

### Cost model

Apache-2.0 per plugins/mcp-server-dev/LICENSE; the mcpb CLI runs through npx and Python dependencies are vendored with pip

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [build-mcpb SKILL.md ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/skills/build-mcpb/SKILL.md) Checked 2026-10-21 https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/skills/build-mcpb/SKILL.md Supports: upstreamDescription, summary, whySelected[0], whySelected[1], bestFor[0], bestFor[1], bestFor[2], limitations[1], limitations[2], limitations[3], limitations[4], limitations[5], review.findings[0], review.findings[1], review.findings[2], review.findings[3], install.steps[2], install.prerequisites[1], access.permissions[0], access.permissions[1], access.permissions[2], access.cost
- [mcp-server-dev README ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/README.md) Checked 2026-10-21 https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/README.md Supports: install.sourceUrl, install.steps[0], install.steps[1], limitations[6]
- [mcp-server-dev LICENSE ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/LICENSE) Checked 2026-10-21 https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/plugins/mcp-server-dev/LICENSE Supports: license, access.cost
- [Repository README, installation ↗](https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/README.md) Checked 2026-10-21 https://raw.githubusercontent.com/anthropics/claude-plugins-official/41f32e407b450055044f167db7ded5e8ff67d203/README.md Supports: install.steps[0], install.prerequisites[0], compatibility

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### Build an MCP App (Interactive UI Widgets) ↗ Adds interactive UI widgets (forms, pickers, confirm dialogs, charts) to an MCP server: the tool declares a ui:// resource, the server serves the widget HTML, and the host renders it in a sandboxed iframe in the chat.](/skills/anthropic-build-mcp-app/)[### Build an MCP Server ↗ Interviews the developer about an MCP server before any code, recommends one deployment model and a tool-design pattern, then scaffolds a remote or local stdio server or hands off to the MCP app or MCPB skill.](/skills/anthropic-build-mcp-server/)[### Agent Platform GenAI Inference ↗ Calls Gemini and third-party OpenMaaS models on Google Cloud Agent Platform, asking for model, project and region instead of defaulting.](/skills/google-agent-platform-inference/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Choose a toolkit](/tools/)
- [Inspect execution hosts](/agents/)
- [Check tool access](/mcp-servers/)
- [Check project dependencies](/check-repo/)
