本指南将帮助您构建 MCP Bundle (.mcpb)，以创建用于内部使用、私有分发或作为提交至 Anthropic 连接器目录基础的桌面扩展。
1. 简介
什么是 MCPB？
MCPB (.mcpb) 文件是包含本地 MCP 服务器和 manifest.json 的 zip 存档。它们支持在 Claude Desktop 中一键安装，类似于浏览器扩展。
主要特点：
在用户机器上本地运行
通过 stdio 传输进行通信
捆绑所有依赖项
离线工作
无需 OAuth
了解更多：
何时应使用本地服务器 (MCPB) 与远程服务器？
在以下情况下选择本地服务器 (MCPB)：
内部系统和安全性
访问防火墙后的系统（JIRA、Confluence、内部 wiki、私有数据库）
无缝身份验证 - 自动使用现有 SSO 和浏览器会话，无需令牌管理
零信任合规性 - 在公司网络边界内运行，无需公开暴露内部资源
本地资源
直接文件系统访问，用于代码编辑和 Git 操作
与本地安装的工具集成（Docker、IDE、数据库）
硬件集成和桌面应用程序控制
不应离开用户机器的隐私敏感操作
企业部署
一键安装，内置 Node.js 运行时（无需管理依赖项）
无需云基础设施、VPN 配置或防火墙规则
组织级控制 - 管理员可以上传自定义扩展并通过允许列表管理访问
完全控制身份验证、授权和审计日志
在以下情况下选择远程连接器：
需要集中基础设施的云服务和公共 API
跨 Claude Web、移动和桌面版本分发
需要跨所有用户集中更新的服务
需要服务器端令牌管理的 OAuth 流程
多个组织使用的面向公众的集成
关键区别：MCPB 通过 stdio 传输在用户机器上运行，可访问本地和内部资源。远程连接器在您的服务器上通过 HTTPS 运行，并通过 Anthropic 基础设施访问。
实际应用：组织正在构建 MCPB 作为内部 MCP 服务器的安全代理、用于内部文档访问，以及连接开发工具，同时保持其安全架构。
远程连接器指导：有关完整的远程连接器文档，请参阅 MCP 合作伙伴常见问题。
2. 入门
我应该使用哪种编程语言？
强烈推荐 Node.js，原因如下：
随 Claude macOS 和 Windows 版本一起提供（用户零安装摩擦）
用户无需单独安装运行时
与 Claude Desktop 的最佳兼容性和可靠性
广泛的 MCP SDK 支持
我应该支持哪些平台？
Claude Desktop 运行在：
macOS (darwin)
Windows (win32)
在 manifest.json 兼容性部分中指定支持的平台。
最佳实践：即使您主要在一个平台上开发，也应在两个平台上测试。
平台兼容性详情：有关平台规范和运行时要求，请参阅 MCPB Manifest 规范 - 兼容性。
我如何创建我的第一个 MCPB？
遵循以下五步流程：
1. 安装 MCPB CLI：npm install -g @anthropic-ai/mcpb
2. 创建您的 MCP 服务器（参见 MCP SDK）
3. 运行 mcpb init 创建 manifest.json
4. 运行 mcpb pack 进行捆绑
5. 在 Claude Desktop 中安装和测试
有关详细的实现指导：
MCPB 存储库 - 完整的入门指南、CLI 使用和规范