Claude Desktop Extensions 发布说明 / 更新内容
Anthropic 推出了 Desktop Extensions,这是一种全新的打包格式,允许用户通过单击即可将 Model Context Protocol (MCP) 服务器安装到 Claude Desktop 中。此次更新消除了用户安装 Node.js 或 Python 等运行时、手动编辑 JSON 配置文件或解决依赖冲突的需求。
简化 MCP 服务器安装
Desktop Extensions 将本地 MCP 服务器的安装从手动、以开发者为中心的过程转变为流线型的用户体验。此前,用户必须安装运行时、手动编辑 ~/.claude/claude_desktop_config.json 并管理软件包版本。通过新的 .mcpb (MCP Bundle) 文件扩展名——它取代了之前的 .dxt 扩展名——用户现在只需下载一个 bundle 并双击即可通过 Claude Desktop 进行安装。
.mcpb 文件的技术架构
Desktop Extension 是一个 ZIP 压缩包,它将 MCP 服务器实现及其所有依赖项打包进一个单一的包中。其架构由以下组件组成:
- manifest.json: 唯一必需的文件,包含元数据、配置和运行时要求。
- server/: 包含 MCP 服务器实现的目录。
- dependencies/: 所有必需的软件包和库(例如,Node.js 的
node_modules或 Python 的lib)。 - icon.png: 扩展程序的可选图标。
Claude Desktop 通过内置 Node.js 运行时、为扩展程序提供自动更新并将敏感 API 密钥存储在操作系统的钥匙串中,从而简化了运行时环境。
清单规范 (The Manifest Specification)
manifest.json 文件定义了扩展程序如何运行。关键功能包括:
- 运行时支持: 支持
node、python和binary服务器类型。 - 用户配置: 开发者可以定义必需的输入(例如,
api_key或allowed_directories)。Claude Desktop 会为这些输入提供 UI,对其进行验证并将其敏感值存储在操作系统的机密库中。 - 动态变量: 清单支持模板字面量,例如用于安装目录的
${__dirname}和用于用户提供值的${user_config.key}。 - 跨平台覆盖: 开发者可以为
win32、darwin和linux指定特定平台的命令或环境变量。
开发者工具链与工作流
Anthropic 提供了一套开源工具链,以帮助开发者将现有的 MCP 服务器打包成 Desktop Extensions。工作流涉及四个主要步骤:
- 初始化: 运行
npx @anthropic-ai/mcpb init通过交互式工具生成manifest.json。 - 配置: 在清单的
user_config部分定义用户必需的输入。 - 打包: 运行
npx @anthropic-ai/mcpb pack以验证清单并生成.mcpb归档文件。 - 测试: 将生成的文件拖入 Claude Desktop Settings 窗口进行安装。
生态系统与企业级安全
为了培养广泛的生态系统,Anthropic 已将 MCPB 规范、打包工具和参考实现开源。这使得其他 AI 桌面应用程序也可以采用 .mcpb 格式,以实现一致的扩展支持。
企业管理
对于组织部署,Anthropic 引入了几项安全和管理控制措施:
- 部署: 支持组策略 (Windows) 和 MDM (macOS) 以预装经批准的扩展程序。
- 控制: 能够将特定的发布者或扩展程序列入黑名单,或完全禁用内置的扩展程序目录。
- 私有目录: 支持部署私有的、特定于组织的扩展程序目录。
功能与使用场景
Desktop Extensions 使 Claude 能够与本地应用程序和私有数据进行交互,同时将这些数据保留在用户的机器上。作为概念验证,Anthropic 展示了一个将 Claude 连接到 PyBoy GameBoy 模拟器的扩展程序,允许模型控制模拟器来玩 Super Mario Land 等游戏。
Sources
相关
- 项目
- Dispatch
- 项目
- 项目
- 项目