Skip to content

Commit d0581a9

Browse files
authored
Revise MCPB adoption blog post for clarity and links (modelcontextprotocol#1873)
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.
1 parent 3516cd2 commit d0581a9

File tree

1 file changed

+18
-19
lines changed

1 file changed

+18
-19
lines changed
Lines changed: 18 additions & 19 deletions
Original file line numberDiff line numberDiff line change
@@ -1,21 +1,20 @@
11
+++
22
date = '2025-11-21T00:00:00+00:00'
33
publishDate = '2025-11-21T00:00:00+00:00'
4-
draft = false
54
title = 'Adopting the MCP Bundle format (.mcpb) for portable local servers'
65
author = 'David Soria Parra (MCP Lead Maintainer), Joan Xie (MCPB Maintainer)'
76
tags = ['mcp', 'mcpb', 'bundles']
87
+++
98

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 servers across 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).
1110

1211
## What are MCP Bundles?
1312

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.
1514

1615
A basic bundle structure looks like:
1716

18-
```
17+
```text
1918
bundle.mcpb (ZIP file)
2019
├── manifest.json # Required: Bundle metadata and configuration
2120
├── server/ # Server implementation
@@ -24,34 +23,34 @@ bundle.mcpb (ZIP file)
2423
└── icon.png # Optional: Bundle icon
2524
```
2625

27-
The format supports servers written in Node.js, Python, or compiled binariesgiving 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.
2827

2928
## Why move MCPB to the MCP project?
3029

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:
3631

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).
3836

3937
## What this means for developers
4038

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:
4240

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.
4443

4544
## Getting started
4645

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!
4847

4948
## Acknowledgements
5049

5150
Thanks to the MCP contributors and maintainers involved in making this happen, including:
5251

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_)
53+
- [Adam Jones](https://github.com/domdomegg) (_MCP Maintainer_)
54+
- [Joan Xie](https://github.com/joan-anthropic) (_MCPB Maintainer_)
55+
- [Felix Rieseberg](https://github.com/felixrieseberg) (_MCPB Maintainer_)
56+
- [Alex Sklar](https://github.com/asklar) (_MCPB Maintainer_)

0 commit comments

Comments
 (0)