采用 MCP Bundle 格式 (.mcpb) 实现便携式本地服务器

MCP Bundle 格式 (MCPB) 现已纳入 Model Context Protocol 项目。这种分发格式简化了开发者打包和共享本地 MCP 服务器的方式，使用户能够在任何兼容的客户端中安装，包括 Claude 桌面应用、Claude Code 和 MCP for Windows。

什么是 MCP Bundles？

MCP Bundles 是包含本地 MCP 服务器和 manifest.json 的 ZIP 归档文件，该文件描述了服务器及其功能。该格式类似于 Chrome 扩展 (.crx) 或 VS Code 扩展 (.vsix)，使最终用户能够一键安装本地 MCP 服务器。

基本的 Bundle 结构如下：

bundle.mcpb (ZIP file)
├── manifest.json      # Required: Bundle metadata and configuration
├── server/            # Server implementation
│   └── index.js
├── node_modules/      # Bundled dependencies
└── icon.png           # Optional: Bundle icon

该格式支持用 Node.js、Python 或编译二进制文件编写的服务器，为开发者提供了构建集成的灵活性，同时为用户保持了一致的分发机制。

为什么将 MCPB 迁移到 MCP 项目？

Anthropic 最初为 Claude 的桌面应用开发了 MCPB（以前称为 DXT）。然而，我们认为当可移植性扩展到任何单一客户端之外时，本地 MCP 服务器生态系统会受益。通过将 Bundle 规范、CLI 工具 和 参考实现 移至 MCP 项目，我们实现了：

跨客户端兼容性

为一个 MCP 兼容应用创建的 Bundle 应该在任何其他实现规范的应用中工作。开发者可以分发一次他们的工作，并在整个生态系统中接触用户。

生态系统级工具

mcpb CLI 和相关库现在开放给社区扩展、改进和构建。客户端开发者可以采用标准化代码来加载和验证 Bundle。

用户友好的安装

无论用户喜欢哪种 AI 应用，最终用户都能从一致的安装体验中受益。配置变量、权限和更新可以统一处理。

共享社区

MCPB 贡献者现在可以在 MCP 社区的开放环境中与 MCP 社区的其他成员协作。

对开发者的影响

这种过渡主要是后勤变更，但也为实现者带来了一些好处。

服务器开发者

您可以使用 MCPB 为多个客户端打包和分发您的本地 MCP 服务器。mcpb CLI 帮助您创建 manifest.json 并将服务器打包成 .mcpb 文件。

客户端开发者

您可以使用开源工具链为您的应用添加 MCP Bundles 支持。该仓库 包含 Claude 用于 macOS 和 Windows 的模式及关键函数，您可以将其调整用于自己的客户端。

快速开始

访问仓库开始使用：modelcontextprotocol/mcpb。我们欢迎反馈和贡献！

Bundle Manifest 示例

{
  "name": "my-mcp-server",
  "version": "1.0.0",
  "description": "我的 MCP 服务器",
  "author": "开发者名称",
  "license": "MIT",
  "mcp": {
    "version": "1.0.0",
    "capabilities": {
      "resources": {},
      "tools": {}
    }
  },
  "entrypoint": "server/index.js",
  "icon": "icon.png",
  "variables": [
    {
      "name": "API_KEY",
      "description": "API 密钥",
      "required": true,
      "secret": true
    }
  ]
}

使用 CLI 打包

# 安装 CLI
npm install -g @modelcontextprotocol/mcpb

# 创建新的 Bundle 项目
mcpb init my-server

# 构建 Bundle
mcpb build

# 验证 Bundle
mcpb validate my-server.mcpb

# 安装 Bundle（在支持 MCPB 的客户端中）
mcpb install my-server.mcpb

资源

• MCPB 规范: MANIFEST.md
• CLI 文档: CLI.md
• 示例: examples 目录
• 仓库: github.com/modelcontextprotocol/mcpb

致谢

感谢参与此事的 MCP 贡献者和维护者：

• David Soria Parra (MCP 首席维护者)
• Adam Jones (MCP 维护者)
• Joan Xie (MCPB 维护者)
• Felix Rieseberg (MCPB 维护者)
• Alex Sklar (MCPB 维护者)