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 文件定义了扩展程序如何运行。关键功能包括:

  • 运行时支持: 支持 nodepythonbinary 服务器类型。
  • 用户配置: 开发者可以定义必需的输入(例如,api_keyallowed_directories)。Claude Desktop 会为这些输入提供 UI,对其进行验证并将其敏感值存储在操作系统的机密库中。
  • 动态变量: 清单支持模板字面量,例如用于安装目录的 ${__dirname} 和用于用户提供值的 ${user_config.key}
  • 跨平台覆盖: 开发者可以为 win32darwinlinux 指定特定平台的命令或环境变量。

开发者工具链与工作流

Anthropic 提供了一套开源工具链,以帮助开发者将现有的 MCP 服务器打包成 Desktop Extensions。工作流涉及四个主要步骤:

  1. 初始化: 运行 npx @anthropic-ai/mcpb init 通过交互式工具生成 manifest.json
  2. 配置: 在清单的 user_config 部分定义用户必需的输入。
  3. 打包: 运行 npx @anthropic-ai/mcpb pack 以验证清单并生成 .mcpb 归档文件。
  4. 测试: 将生成的文件拖入 Claude Desktop Settings 窗口进行安装。

生态系统与企业级安全

为了培养广泛的生态系统,Anthropic 已将 MCPB 规范、打包工具和参考实现开源。这使得其他 AI 桌面应用程序也可以采用 .mcpb 格式,以实现一致的扩展支持。

企业管理

对于组织部署,Anthropic 引入了几项安全和管理控制措施:

  • 部署: 支持组策略 (Windows) 和 MDM (macOS) 以预装经批准的扩展程序。
  • 控制: 能够将特定的发布者或扩展程序列入黑名单,或完全禁用内置的扩展程序目录。
  • 私有目录: 支持部署私有的、特定于组织的扩展程序目录。

功能与使用场景

Desktop Extensions 使 Claude 能够与本地应用程序和私有数据进行交互,同时将这些数据保留在用户的机器上。作为概念验证,Anthropic 展示了一个将 Claude 连接到 PyBoy GameBoy 模拟器的扩展程序,允许模型控制模拟器来玩 Super Mario Land 等游戏。

Sources

相关

  • 项目
  • Dispatch
  • 项目
  • 项目
  • 项目