build-mcpb

Package an MCP server into a self-contained .mcpb bundle with runtime.

231|217|Updated Mar 31, 2026
One-click install
npx skills add https://github.com/fazxes/Claude-code --skill build-mcpb-fazxes
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-mcpb
Source: https://github.com/fazxes/Claude-code/tree/main/stubs/downloads/official-plugins/marketplaces/claude-plugins-official/plugins/mcp-server-dev/skills/build-mcpb
Command: npx skills add https://github.com/fazxes/Claude-code --skill build-mcpb-fazxes

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

MCPB bundles a local MCP server with its runtime into a single portable package, enabling offline deployment without requiring the user to install Node, Python, or toolchains.

Core Features & Use Cases

  • Bundles server code (server/), a manifest.json, and a runtime into a single .mcpb archive.
  • Defines an entry point and config for a stdio MCP server with a documented mcp_config.
  • Supports local desktop apps and OS integration by packaging dependencies and enabling offline distribution.

Quick Start

Run the MCPB packaging workflow on your MCP project to produce a distributable .mcpb bundle.

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 offline local deployment?

To package an MCP server for offline deployment, bundle the server code, a manifest.json, and the required runtime into a single portable .mcpb archive. This self-contained bundle allows the server to run locally without requiring users to install separate toolchains.

What is an MCPB bundle and when do I need it?

An MCPB bundle is a self-contained archive that packages a local MCP server with its runtime, enabling offline distribution. You need it when distributing a server to environments without Node, Python, or toolchain access, such as local desktop applications.

Do I need Python or Node installed to run a packaged MCP server?

No, you do not need Python or Node installed to run a packaged MCP server. The MCPB bundle includes the necessary runtime and dependencies within the archive, allowing the server to execute independently without a separate toolchain.

How do I configure environment variables and entry points in an MCPB manifest?

You configure environment variables and entry points by defining them within the mcp_config section of the manifest.json. This manifest-driven workflow supports environment substitution and validation steps to correctly set up the stdio MCP server.

What's the best way to distribute a local MCP server with filesystem access?

The best way to distribute a local MCP server with filesystem access is creating an MCPB bundle. It packages the server code and runtime together, satisfying manifest and packaging requirements for secure, offline local deployment.