本指南将帮助您构建 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 网页版、移动版和桌面版分发
需要跨所有用户集中更新的服务
需要服务器端令牌管理的 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 README 的"For Bundle Developers"部分。
重要：在分发您的 MCPB 之前，请查看 MCPB README 中的测试和最佳实践指导，以确保质量。
3. 配置
什么是 manifest.json？
manifest.json 文件是必需的元数据，描述您的 MCPB - 它的功能、运行方式、提供的工具以及所需的配置。
有关最新信息，请参阅官方 MCPB 规范。
MCPB Manifest 规范 - 完整的模式和所有字段
示例 Manifest - 真实实现
CLI 文档 - 命令参考
我如何添加图标？
图标是可选的，但建议用于专业外观。
基本方法：在捆绑根目录中包含 icon.png 文件，并在 manifest.json 中引用它。
要求：
文件名：icon.png（或自定义路径）
大小：建议 512×512px（最小 256×256px）
格式：支持透明度的 PNG
位置：捆绑根目录或指定路径
高级选项：针对不同大小和主题的多个图标变体（浅色/深色模式支持）。
实现详情：请参阅 MCPB Manifest 规范 - 图标了解：
图标字段配置
多个图标变体语法
大小和主题规范
最佳实践和要求
用户如何配置我的 MCPB？
在 manifest.json 中定义 user_config 部分。Claude Desktop 会自动创建一个设置 UI，用户可以在其中配置您的扩展。
请参阅 MCPB Manifest 规范 - 用户配置了解完整实现：
完整的模式和示例
所有配置类型和属性
验证约束
敏感数据处理
多选模式
用户如何安装我的 MCPB？
有三种不同的安装方法：
双击 - 下载 .mcpb 文件并双击打开
拖放 - 将 .mcpb 文件拖放到 Claude Desktop 窗口中
文件菜单 - 开发者 → 扩展 → 安装扩展 → 选择 .mcpb 文件
所有方法都会打开安装 UI，用户可以：
查看扩展详情和权限
配置必需的设置
授予必要的权限
完成安装
安装范围：按用户安装 - 每个用户必须在自己的系统上单独安装。
用户体验和管理员控制：有关最终用户安装体验和企业管理员控制（包括团队/企业组织管理和策略配置）的详细信息，请参阅：
Claude Desktop 上的本地 MCP 服务器入门 - 完整的用户指南，涵盖目录浏览、安装 UI、故障排除和管理员控制。
4. 资源
官方文档
MCPB 框架：
MCPB 存储库 - 完整规范和工具
MCPB Manifest 规范 - 完整的 manifest 模式
MCPB CLI 文档 - 命令行工具参考
MCPB 示例 - 参考实现
MCP 协议：
MCP 规范 - 协议文档
MCP 快速入门 - 入门指南
TypeScript SDK - Node.js 实现
Python SDK - Python 实现
Claude Desktop：
获取帮助
支持渠道：
MCPB GitHub Issues - 错误报告和功能请求
MCP 规范 - 协议问题
Claude 支持 - 一般 Claude Desktop 支持
社区资源：
查看存储库讨论以获取社区问答
关注发布说明以获取最新更新
查看示例以了解实现模式
准备好公开分发了吗？
如果您已构建了一个可工作的 MCPB，并希望将其提交到 Anthropic 目录以获得更广泛的分发和可发现性，请参阅我们的配套指南：提交到 Anthropic 目录。
目录指南涵盖其他要求，包括：
所有工具的强制工具注释
隐私政策要求
最少三个工作示例
测试凭证（如适用）
完整的提交流程和审查时间表