build-mcpb

Bundle a local MCP server with its runtime into a single .mcpb file.

Updated Apr 19, 2026
One-click install
npx skills add https://github.com/cjrfoto/claude-config --skill build-mcpb-cjrfoto
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: build-mcpb
Source: https://github.com/cjrfoto/claude-config/tree/main/plugins/marketplaces/claude-plugins-official/plugins/mcp-server-dev/skills/build-mcpb
Command: npx skills add https://github.com/cjrfoto/claude-config --skill build-mcpb-cjrfoto

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Packages an MCP server with its runtime into a single distributable bundle, enabling offline installation without requiring a host toolchain.

Core Features & Use Cases

  • Bundles a server binary with its runtime into a single .mcpb file for desktop deployment.
  • Defines a compatible manifest and mcp_config to start the server from the bundle.
  • Supports packaging for Node or Python servers to run on Windows, macOS, and Linux.

Quick Start

Run the MCPB packaging flow to generate a single .mcpb bundle for your local MCP server.

Frequently Asked Questions about build-mcpb

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

FAQPage Schema
How do I bundle a local MCP server with its runtime for offline desktop distribution?

To bundle an MCP server for offline distribution, you package the server binary and its runtime into a single .mcpb file. This self-contained bundle enables desktop installation without requiring users to have a host toolchain installed.

Can I package Node and Python MCP servers into a single bundle?

Yes, you can package both Node and Python MCP servers into a single bundle. The packaging process applies the necessary runtime steps for either environment, ensuring the server starts correctly from the generated .mcpb file.

What is an .mcpb file and when do I need it for server deployment?

An .mcpb file is a self-contained bundle that packages an MCP server with its runtime. You need it for desktop deployments where a single-file bundle is preferred for user installation and seamless OS integration without a host toolchain.

Does MCP server packaging work across Windows, macOS, and Linux?

Yes, MCP server packaging supports desktop deployments across Windows, macOS, and Linux. The bundling process defines a compatible manifest and mcp_config to ensure the server starts properly from the bundle on these operating systems.

How do I generate a distributable MCP server bundle from a local server?

You generate a distributable bundle by running the MCPB packaging flow on your local server. This process satisfies the manifest presence, server entry, and mcp_config requirements, outputting a single .mcpb file ready for offline installation.

What are the limitations of bundling an MCP server into a single file?

Bundling an MCP server into a single file is primarily designed for desktop deployments and offline distribution. It may not suit server-scale environments where a full toolchain is already present or where multi-file containerized deployments are preferred over single-file OS integration.