skills.rest
Leap0920
Leap0920COMMUNITY
Explore all skills by this author →
WebsiteGitHub

build-mcpb

Package stdio MCP servers with runtimes into .mcpb archives.

1|Updated Mar 30, 2026
Search Tags:#distribution#bundling#mcp server#stdio#manifest.json#mcpb#local filesystem
One-click install
npx skills add https://github.com/Leap0920/Clean-Portfolio --skill build-mcpb-leap0920
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: build-mcpb
Source: https://github.com/Leap0920/Clean-Portfolio/tree/main/%25USERPROFILE%25/.openclaude/plugins/marketplaces/claude-plugins-official/plugins/mcp-server-dev/skills/build-mcpb
Command: npx skills add https://github.com/Leap0920/Clean-Portfolio --skill build-mcpb-leap0920

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

It solves the friction of distributing a local MCP server to users who may not have Node, Python, or your build toolchain installed by packaging your server with its runtime so it runs as a single .mcpb install.

Core Features & Use Cases

  • Bundle-and-run distribution (MCPB): Create a local MCP server packaged with its runtime so the host can launch it via the manifest without requiring the user to set up dependencies.
  • Filesystem-capable local tools: Use when your MCP tools need to interact with the user’s machine (local files, desktop/OS integration, localhost services).
  • Stdio-server compatibility: Keep your server logic as a normal stdio MCP server while MCPB handles the packaging and manifest-driven launch.
  • Secure-by-design guidance: Includes an explicit emphasis that MCPB provides no sandbox, requiring careful path validation and other safety controls in your tool handlers.

Quick Start

Generate an MCPB bundle for your local stdio MCP server by writing a manifest.json at the bundle root and then running the MCPB pack command to produce a distributable .mcpb file.

Frequently Asked Questions about build-mcpb

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

FAQPage Schema
How do I package a local MCP server for users who don't have Node or Python installed?▼

You can package a local stdio MCP server into an MCPB archive that bundles the server code with its runtime, allowing users to install and launch it without setting up dependencies or toolchains.

What is an MCPB file used for in MCP server distribution?▼

An MCPB file is a distributable archive that packages a local stdio MCP server and its runtime together, enabling the host application to launch the server via a manifest without requiring manual environment setup.

How do I create a manifest.json for an MCPB bundle?▼

You create a manifest.json at the bundle root directory specifying the launch command and user_config, then run the MCPB pack command to validate the configuration and produce the distributable .mcpb file.

When should I use MCPB packaging instead of just running a remote MCP server?▼

Use MCPB packaging when your MCP tools need to access the user's local filesystem, interact with desktop or OS capabilities, or communicate with localhost services rather than only calling remote cloud APIs.

Does MCPB provide a sandbox for local filesystem access?▼

No, MCPB provides no sandbox, which means you must implement careful path validation and other safety controls directly in your tool handlers to ensure secure local filesystem access.

Can I bundle a stdio MCP server that needs localhost services into an MCPB file?▼

Yes, you can bundle any stdio MCP server that requires localhost services or local filesystem access into an MCPB archive, as long as you define the launch command and user_config in the manifest.json.

Related Skills

Explore More Software Engineering Skills→
dobrinz123dobrinz123

build-mcpb

Package MCP server code and runtime into a single .mcpb file.

Community
Advanced
VivekSinghRathore7VivekSinghRathore7

build-mcpb

Package a local MCP server with its runtime into an MCPB file.

Community
Advanced
NGTPTENGTPTE

build-mcpb

Package a local MCP server into a self-contained MCPB bundle.

Community
Advanced
onelee85onelee85

build-mcpb

Package self-contained MCP servers into MCPB bundles with manifest.json and server/index.js.

Community
Advanced