build-mcpb

Package local MCP servers with bundled runtimes into installable .mcpb archives.

16|1|Updated Mar 20, 2026
One-click install
npx skills add https://github.com/SocialGouv/iterion --skill build-mcpb-socialgouv
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: build-mcpb
Source: https://github.com/SocialGouv/iterion/tree/main/vendor/github.com/SocialGouv/claw-code-go/internal/tools/bundled_skills/mcp-server-dev/skills/build-mcpb
Command: npx skills add https://github.com/SocialGouv/iterion --skill build-mcpb-socialgouv

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Distributing a local MCP server normally requires users 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 drag-and-drop, no toolchain required. ## Core Features & Use Cases - Manifest Authoring: Create a valid manifest.json (v0.4) with entry points, launch commands, install-time user config, and platform compatibility gates. - Build Pipeline Guidance: Bundle Node servers with esbuild or vendor Python dependencies, then validate and pack with the @anthropic-ai/mcpb CLI. - Local Security Hardening: Apply mandatory path-containment checks, command-injection prevention, read-only tool splits, and resource caps, since MCPB provides no sandbox. - Use Case: You built an MCP server that reads files from the user's local filesystem. Use this Skill to bundle it with its Node runtime, define a directory-picker config field, sign the package, and ship a single .mcpb file users install in Claude Desktop. ## Quick Start Ask the AI to package your local MCP server into an installable .mcpb bundle with a valid 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 better choice.

Does MCPB provide a sandbox or permissions system?▼

No. MCPB has no permissions block and the server runs with full user privileges. You must implement path containment checks, command allowlists, and resource limits inside your own tool handlers.

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

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 the .mcpb on a machine without your dev toolchain installed, and vendor or bundle all dependencies before packing.