You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Updated the blog post to improve clarity, add relevant links to MCPB resources, and enhance formatting. Expanded explanations of MCPB benefits, clarified bundle structure, and updated acknowledgements with contributor profiles.
title = 'Adopting the MCP Bundle format (.mcpb) for portable local servers'
6
5
author = 'David Soria Parra (MCP Lead Maintainer), Joan Xie (MCPB Maintainer)'
7
6
tags = ['mcp', 'mcpb', 'bundles']
8
7
+++
9
8
10
-
The [MCP Bundle format (.mcpb)](https://github.com/modelcontextprotocol/mcpb) is now part of the Model Context Protocol project. This makes it easier for developers to distribute local MCP serversacross any compatible client, including Claude desktop app, Claude Code, and MCP for Windows.
9
+
The [MCP Bundle format](https://github.com/modelcontextprotocol/mcpb)(MCPB) is now part of the [Model Context Protocol project](https://github.com/modelcontextprotocol). This distribution format simplifies how developers package and share local MCP servers, enabling users to install them across any compatible client, including the [Claude desktop app](https://claude.com/download), [Claude Code](https://claude.com/product/claude-code), and [MCP for Windows](https://learn.microsoft.com/windows/ai/mcp/servers/mcp-server-overview).
11
10
12
11
## What are MCP Bundles?
13
12
14
-
MCP Bundles are zip archives containing a local MCP server and a `manifest.json` that describes the server and its capabilities. The format is similar to Chrome extensions (.crx) or VS Code extensions (.vsix), enabling end users to install local MCP servers with a single click.
13
+
MCP Bundles are ZIP archives containing a local MCP server and a `manifest.json` that describes the server and its capabilities. The format is similar to Chrome extensions (`.crx`) or VS Code extensions (`.vsix`), enabling end users to install local MCP servers with a single click.
15
14
16
15
A basic bundle structure looks like:
17
16
18
-
```
17
+
```text
19
18
bundle.mcpb (ZIP file)
20
19
├── manifest.json # Required: Bundle metadata and configuration
21
20
├── server/ # Server implementation
@@ -24,34 +23,34 @@ bundle.mcpb (ZIP file)
24
23
└── icon.png # Optional: Bundle icon
25
24
```
26
25
27
-
The format supports servers written in Node.js, Python, or compiled binaries—giving developers flexibility in how they build while maintaining a consistent distribution mechanism for users.
26
+
The format supports servers written in Node.js, Python, or compiled binaries, giving developers flexibility in how they build their integrations, while maintaining a consistent distribution mechanism for users.
28
27
29
28
## Why move MCPB to the MCP project?
30
29
31
-
Anthropic originally developed this format (previously called DXT) for Claude's desktop applications. However, we believe the local MCP server ecosystem benefits when portability extends beyond any single client. By moving the bundle specification, CLI tooling, and reference implementation to the MCP project, we're enabling:
32
-
33
-
**Cross-client compatibility:** A bundle created for one MCP-compatible application should work in any other that implements the specification. Developers can distribute their work once and reach users across the ecosystem.
34
-
35
-
**Ecosystem-wide tooling:** The `mcpb` CLI and associated libraries are now open for the community to extend, improve, and build upon. Client developers can adopt standardized code for loading and verifying bundles.
30
+
Anthropic originally developed MCPB (previously called DXT) for Claude's desktop applications. However, we believe the local MCP server ecosystem benefits when portability extends beyond any single client. By moving the [bundle specification](https://github.com/modelcontextprotocol/mcpb/blob/main/MANIFEST.md), [CLI tooling](https://github.com/modelcontextprotocol/mcpb/blob/main/CLI.md), and [reference implementation](https://github.com/modelcontextprotocol/mcpb/tree/main/examples) to the MCP project, we're enabling:
36
31
37
-
**User-friendly installation:** End users benefit from a consistent installation experience regardless of which AI application they prefer. Configuration variables, permissions, and updates can be handled uniformly.
32
+
-**Cross-client compatibility:** A bundle created for one MCP-compatible application should work in any other that implements the specification. Developers can distribute their work once and reach users across the ecosystem.
33
+
-**Ecosystem-wide tooling:** The `mcpb` CLI and associated libraries are now open for the community to extend, improve, and build upon. Client developers can adopt standardized code for loading and verifying bundles.
34
+
-**User-friendly installation:** End users benefit from a consistent installation experience regardless of which AI application they prefer. Configuration variables, permissions, and updates can be handled uniformly.
35
+
-**Shared community:** MCPB contributors can now collaborate in the open with the rest of the [MCP community](https://modelcontextprotocol.io/community/communication).
38
36
39
37
## What this means for developers
40
38
41
-
**Servers:** You can use MCPB to package your local MCP servers for distribution across multiple clients. The `mcpb` CLI helps you create a `manifest.json` and package your server into a `.mcpb` file. Once packaged, users can install your server with a single click in any client that supports MCP Bundles.
39
+
This transition is mostly a logistical change, but also brings some benefits to implementers. For those that are building:
42
40
43
-
**Clients:** You can add support for MCP Bundles to your application using the open-source toolchain. The repository includes the schemas and key functions used by Claude for macOS and Windows to implement bundle support, which you can adapt for your own client.
41
+
-**Servers:** You can use MCPB to package your local MCP servers for distribution across multiple clients. The `mcpb` CLI helps you create a `manifest.json` and package your server into a `.mcpb` file. Once packaged, users can install your server with a single click in any client that supports MCP Bundles.
42
+
-**Clients:** You can add support for MCP Bundles to your application using the open source toolchain. [The repository](https://github.com/modelcontextprotocol/mcpb) includes the schemas and key functions used by Claude for macOS and Windows to implement bundle support, which you can adapt for your own client.
44
43
45
44
## Getting started
46
45
47
-
Check out the repo to get started: [modelcontextprotocol/mcpb](https://github.com/modelcontextprotocol/mcpb). We encourage feedback and contributions.
46
+
Check out the repo to get started: [modelcontextprotocol/mcpb](https://github.com/modelcontextprotocol/mcpb). We encourage [feedback](https://github.com/modelcontextprotocol/mcpb/issues) and contributions!
48
47
49
48
## Acknowledgements
50
49
51
50
Thanks to the MCP contributors and maintainers involved in making this happen, including:
52
51
53
-
- David Soria Parra (MCP Lead Maintainer)
54
-
- Adam Jones (MCP Maintainer)
55
-
- Joan Xie (MCPB Maintainer)
56
-
- Felix Rieseberg (MCPB Maintainer)
57
-
- Alex Sklar (MCPB Maintainer)
52
+
-[David Soria Parra](https://github.com/dsp-ant) (_MCP Lead Maintainer_)
0 commit comments