build-mcpb

Package local MCP servers with bundled runtimes into distributable MCPB archives.

1|Updated Mar 26, 2026
One-click install
npx skills add https://github.com/todevelopers/todevelopers-marketplace --skill build-mcpb-todevelopers
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-mcpb
Source: https://github.com/todevelopers/todevelopers-marketplace/tree/main/plugins/mcp-builder/skills/build-mcpb
Command: npx skills add https://github.com/todevelopers/todevelopers-marketplace --skill build-mcpb-todevelopers

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Distributing a local MCP server normally requires every user to install Node or Python and manage dependencies themselves. This Skill guides you through packaging your server with its runtime into a single .mcpb file that installs with one click on Claude Desktop. ## Core Features & Use Cases - Manifest Authoring: Create a valid manifest.json (v0.4) with entry points, user_config install-time settings, and platform compatibility gates. - Build Pipelines: Bundle Node servers with esbuild or vendor Python dependencies, then validate and pack with the @anthropic-ai/mcpb CLI. - Local Security Guidance: Implement path-traversal containment, command-injection prevention, and resource limits, since MCPB provides no sandbox. - Use Case: You built an MCP server that reads local files. Use this Skill to bundle it with its Node runtime, add a directory-picker config field, sign the package, and ship a single .mcpb file users can drag onto Claude Desktop. ## Quick Start Package my local MCP server in this directory into an installable MCPB bundle with a proper manifest and bundled dependencies.

Frequently Asked Questions about build-mcpb

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I package an MCP server for distribution?

Bundle your server code and dependencies into a directory with a manifest.json, then run npx @anthropic-ai/mcpb pack to validate and zip it into a .mcpb file. Users install it by dragging the file onto Claude Desktop.

When should I use MCPB instead of a remote MCP server?

Use MCPB only when the server must run on the user's machine, such as reading local files, driving desktop apps, or accessing localhost services. If your server only calls cloud APIs, a remote HTTP server is the recommended distribution path.

Does MCPB provide sandboxing or permissions for local servers?

No. MCPB has no permissions block and the server runs with full user privileges. You must implement path containment checks, avoid shell-based process spawning, and cap resource usage in your own tool handlers.

How do I add install-time configuration to an MCPB package?

Declare fields in the manifest's user_config section with types like string, number, directory, or file. Reference them in server.mcp_config.env using ${user_config.key} substitution; sensitive values are stored in the OS keychain.

Why does my MCPB server work on my machine but fail for users?

This almost always means a dependency was not actually bundled into the package. Test on a machine without your dev toolchain, and either bundle with esbuild or vendor Python packages into the server directory before packing.