build-mcpb

Package a local MCP server with its runtime into a single .mcpb bundle.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

MCPB packaging solves the problem of distributing local MCP servers that run without requiring the end user to install Node or Python or manage dependencies. It creates a single bundle that contains the server, its runtime, and a manifest so distribution and installation are straightforward.

Core Features & Use Cases

  • Bundled runtime MCPB bundle: a single .mcpb file containing manifest.json, server code, and icon for offline distribution.
  • Native deployment: runs on desktop environments without requiring a separate toolchain, enabling local file access and OS-level interactions.
  • Use cases: distributing a local MCP server to users who need offline operation, offline testing, or self-contained desktop apps.

Quick Start

Package your MCP server with its runtime into an MCPB bundle and install the resulting file on Claude Desktop.

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 offline desktop use?

To package a local MCP server for offline desktop use, this Skill bundles the server code with its runtime into a single distributable MCPB file. It validates the MCPB manifest, server entry point, and runtime to create a self-contained .mcpb bundle.

Do I need Node or Python installed to run an MCPB bundle?

No, you do not need Node or Python installed to run an MCPB bundle. The packaging process embeds the compatible runtime directly inside the .mcpb file, allowing the server to execute on desktop platforms without a separate toolchain.

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

An MCPB bundle is a single .mcpb file containing manifest.json, server code, and an icon for offline distribution. You need it when distributing local MCP servers to users who require offline operation or self-contained desktop apps without managing dependencies.

Can I use an MCPB bundle to interact with local files and OS APIs?

Yes, you can use an MCPB bundle to interact with local files and OS APIs. The bundle is designed for native deployment on desktop environments, enabling local file access and OS-level interactions without requiring a separate toolchain.

What inputs are required to create an MCPB bundle?

Creating an MCPB bundle requires a valid MCPB manifest, a server entry point, and a compatible runtime. The Skill validates these inputs and packs the bundle through standard MCPB tooling to produce the final distributable .mcpb file.

How do I deploy a local MCP server on Claude Desktop without dependencies?

To deploy a local MCP server on Claude Desktop without dependencies, package it into an MCPB bundle using this Skill. The resulting .mcpb file contains the server and its runtime, allowing straightforward installation and offline execution on the desktop platform.