skills.rest
thevibeworks
thevibeworksOFFICIAL
Explore all skills by this author →
WebsiteGitHub

build-mcpb

Packages a local MCP server and its runtime into an installable .mcpb bundle.

28|5|Updated Jun 24, 2025
Search Tags:#packaging#mcp server#claude desktop#stdio#mcpb#local filesystem
One-click install
npx skills add https://github.com/thevibeworks/claude-code-docs --skill build-mcpb-thevibeworks
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: build-mcpb
Source: https://github.com/thevibeworks/claude-code-docs/tree/main/content/github/claude-plugins-official/plugins/mcp-server-dev/skills/build-mcpb
Command: npx skills add https://github.com/thevibeworks/claude-code-docs --skill build-mcpb-thevibeworks

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you distribute a local MCP server in a way that runs on the user’s machine without requiring them to install Node.js, Python, or a toolchain.

Core Features & Use Cases

  • Build an MCPB bundle: Create an .mcpb package (zip archive) that includes your MCP server and its runtime dependencies so it can be installed by dragging onto Claude Desktop.
  • Configure identity and launch behavior: Define manifest metadata like manifest_version, entry point, and the stdio command/args/env the host will use to spawn your server.
  • Support local-file and desktop integration: Use MCPB when the MCP server must access the local filesystem, drive desktop apps, talk to localhost services, or use OS-level APIs.

Quick Start

Use the build-mcpb skill to pack your server directory into an .mcpb so it runs with a bundled runtime on the user’s machine.

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 Claude Desktop without requiring users to install Node or Python?▼

Package a local MCP server into an MCPB bundle to distribute it without requiring users to install Node.js, Python, or other toolchains. The bundle includes your server and its runtime dependencies so it can be installed by dragging onto Claude Desktop.

What is an MCPB bundle and when do I need it for my MCP server?▼

An MCPB bundle is a zip archive that includes your MCP server and its runtime dependencies. You need it when your MCP server must access the local filesystem, drive desktop apps, talk to localhost services, or use OS-level APIs instead of only cloud APIs.

How do I configure the launch behavior for an MCP server in an MCPB package?▼

Configure launch behavior by defining manifest metadata like manifest_version, entry point, and the stdio command, args, and env the host will use to spawn your server. A valid manifest.json with an executable stdio launch configuration is required.

Can I distribute my MCP server as an MCPB bundle if it needs local filesystem access?▼

Yes, MCPB bundles specifically target scenarios where the server needs local filesystem access, desktop app control, localhost integration, or OS-level capabilities. Bundling the runtime and dependencies ensures deterministic execution on the user's machine.

Do I need a specific manifest format to build an MCPB package?▼

Yes, building an MCPB package requires a valid manifest.json with an executable stdio launch configuration defined as server.mcp_config. This manifest specifies the entry point and environment variables the host uses to spawn your server.

Related Skills

Explore More Software Engineering Skills→
WizarckWizarck

build-mcpb

Package local MCP servers into distributable MCPB bundles with manifest validation.

Community
Advanced
Leap0920Leap0920
1

build-mcpb

Package stdio MCP servers with runtimes into .mcpb archives.

Community
Intermediate
lucasfthlucasfth

build-mcpb

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

Community
Intermediate
VivekSinghRathore7VivekSinghRathore7

build-mcpb

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

Community
Advanced