Claude Desktop 扩展:一键安装 MCP 服务器
概述
Anthropic 推出了 Desktop Extensions(.mcpb 文件),这是一种新的打包格式,简化了 Claude Desktop 的 Model Context Protocol (MCP) 服务器安装流程。该系统将之前需要开发者工具、手动配置和依赖管理的过程转变为单击即可完成的安装体验。
解决的问题
此前,设置本地 MCP 服务器需要:
- 安装 Node.js、Python 或其他运行时
- 手动编辑 JSON 配置文件
- 解决包版本冲突
- 手动更新服务器
- 没有集中发现机制
这些门槛将 MCP 服务器的访问主要限制在技术用户群体,尽管它们在本地数据访问和应用集成方面具有强大的能力。
改变之处
之前: 用户需要安装运行时、手动配置文件、重启应用程序并排查依赖问题。
之后: 下载 .mcpb 文件,双击它,然后点击"安装"——无需终端操作。
技术架构
Desktop Extensions 是包含以下内容的 ZIP 归档:
manifest.json(必需)- 扩展元数据和配置server/目录 - MCP 服务器实现dependencies/- 所有打包的依赖包icon.png(可选)- 扩展的视觉标识
清单描述了扩展的功能、运行时要求以及任何用户配置需求。Claude Desktop 在内部处理复杂性,包括:
- 内置 Node.js 运行时
- 自动更新
- 在操作系统密钥链中安全存储凭证
清单结构
最小清单包括版本、名称、描述、作者信息和服务器配置。可选字段支持功能声明(工具和提示词)、用户配置需求、跨平台兼容性以及可发现性元数据。
模板字面量如 ${__dirname}、${user_config.key} 和系统变量支持动态配置。扩展可以定义敏感字段(API 密钥),Claude Desktop 会自动安全存储并在运行时注入。
构建扩展
构建过程包括四个步骤:
- 初始化: 运行
npx @anthropic-ai/mcpb init生成清单 - 配置: 在清单中定义所需的用户输入
- 打包: 执行
npx @anthropic-ai/mcpb pack创建.mcpb文件 - 测试: 将文件拖入 Claude Desktop 设置中以验证功能
高级功能
扩展支持:
- 跨平台适配,支持特定操作系统的命令覆盖
- 动态配置,使用模板字面量实现运行时值
- 功能声明,预先描述可用的工具和提示词
- 用户配置,对必需设置进行验证
扩展目录与提交
Anthropic 正在 Claude Desktop 内推出一个精选扩展目录,支持一键发现和安装。开发者在以下操作后可通过表单提交扩展:
- 遵循提交指南
- 在 Windows 和 macOS 上测试
- 通过质量和安全审查
开放生态承诺
公司正在开源:
- 完整的 MCPB 规范
- 打包和验证工具
- 参考实现代码
- TypeScript 类型和模式
这实现了"一次打包,随处运行"的兼容性,不仅限于 Claude,还支持多个 AI 桌面应用。
安全与企业功能
用户保护包括敏感数据的操作系统密钥链存储和自动更新。企业功能包括:
- 组策略和 MDM (macOS) 管理
- 预安装批准的扩展
- 发布者/扩展黑名单
- 禁用目录
- 私有扩展目录
快速开始
开发者应查看开源仓库中的文档并运行初始化命令。桌面用户可以更新 Claude 并访问设置中的扩展部分。企业管理员可以参考部署文档进行组织范围的配置。
创新示例
在内部,Anthropic 使用 Desktop Extensions 打包了 GameBoy 模拟器集成,允许 Claude 直接控制游戏状态——展示了将 AI 能力连接到本地工具和应用的潜力。