# MCP Bundle (MCPB)

> One .mcpb file that holds a local MCP server. You install it in one click.

**Field:** Artificial Intelligence  
**Category:** MCP  
**Also known as:** .mcpb File, MCPB, Desktop Extension (DXT), .dxt File

## Think of it like

It is like a toy that comes with its batteries. You open the box and it just works.

## Definition

An MCP bundle is one .mcpb file that holds a local MCP server and everything it needs to run. It is a zip archive with a manifest.json that says what the server is and how to start it. A user can install it in one click, with no Node or Python setup. The format used to be called Desktop Extensions, with .dxt files. Developers build one with the mcpb tool.

## Example

Someone packs a file search server into search.mcpb. A user opens it in Claude for desktop and clicks Install.

## Example code

```bash
npm install -g @anthropic-ai/mcpb
mcpb init
mcpb pack
```

Install the tool, write the manifest, then pack the .mcpb file.

## Why it matters

Most people cannot set up Node or Python. A bundle lets anyone install a local server like an app.

## Common mistake

Packing a remote server as a bundle. A bundle is for servers that run on the user's own computer.

## Three principles

- **One file.** A zip with a manifest inside.
- **Brings its runtime.** No setup for the user.
- **Local servers only.** It runs on the user's machine.

## Related terms

- [Local MCP Server](https://learn.benibix.com/term/ai/local-mcp-server)
- [MCP Server](https://learn.benibix.com/term/ai/mcp-server)
- [MCP Registry](https://learn.benibix.com/term/ai/mcp-registry)
- [ZIP File](https://learn.benibix.com/term/development/zip-file)
- [Package Manager](https://learn.benibix.com/term/development/package-manager)

![A row of five steps for an MCP server. Write it with an SDK. Test it in the MCP Inspector. Pack it into one .mcpb bundle file. List it in the MCP Registry. A host app finds it and runs it as a local server on the user's computer.](https://learn.benibix.com/diagrams/ai8-mcp-dev-tools.svg)

---

Source: https://learn.benibix.com/term/ai/mcp-bundle
Author: Behnia Zarei (a developer in Vienna, Austria, who builds and teaches data, AI and business intelligence at BENIBIX)
Publisher: BENIBIX Learn (https://learn.benibix.com/)
Last updated: 2026-11-18
Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). Quote freely with attribution.
