Desktop Extensions
来自 Anthropic Engineering · 期号 2025-06-26
摘要
安装 MCP 服务器过去需要装 Node.js、手动改 JSON 配置文件、处理依赖冲突，非技术用户基本用不了。 Anthropic 推出了 Desktop Extensions，把整个 MCP 服务器及其依赖打包成一个 .mcpb 文件，用户下载后双击、点安装即可。 扩展包本质是一个 ZIP 压缩包，内含 manifest.json、服务器代码和依赖库。Claude Desktop 自带 Node.js 运行时，自动处理更新，API 密钥等敏感配置存入系统钥匙串。 文件后缀后来从 .dxt 改为 .mcpb，功能不变。
深读
导读 Anthropic 正式推出了 Desktop Extensions，将 MCP 服务器的安装从需要 Node.js、手动编辑 JSON 配置文件的流程，简化为下载一个 .mcpb 文件、双击、点击安装三步。这篇文章详细解释了这一新格式的技术架构、manifest.json 的配置方式，以及它为开发者和企业用户带来的安全与部署考量。读完能理解 MCPB 包的结构、配置模板变量的用法，以及 Anthropic 在开放生态与安全管控之间的平衡思路。 关键信息 - 安装流程从“安装 Node.js → 手动编辑 ~/.claude/claude_desktop_config.json → 重启 Claude Desktop”简化为“下载 .mcpb 文件 → 双击 → 点击安装”。 - .mcpb 文件本质是一个 ZIP 压缩包，内含 manifest.json、服务器代码和所有依赖库，Claude Desktop 自带 Node.js 运行时，无需用户额外安装。 - manifest.json 中的 user_config 字段可声明 API 密钥等敏感配置，Claude Desktop 会将其存入操作系统钥匙串，并在启动服务器时用 ${user_config.api_key} 模板变量透明替换。 - 文件后缀在 2025 年 9 月 11 日从 .dxt 改为 .mcpb（MCP Bundle），功能不变，旧文件仍可继续使用。 - 企业可通过组策略（Windows）和 MDM（macOS）预装白名单扩展、封禁特定发布者、部署私有扩展目录，或完全禁用扩展目录。 逐节讲解 解决 MCP 安装痛点 文章首先回顾了 MCP 服务器面临的核心问题：用户需要安装 Node.js 或 Python 等运行时，手动编辑 JSON 配置文件，处理依赖冲突，且缺乏发现机制和自动更新。这些门槛使得 MCP 服务器虽然功能强大，但基本只对开发者可用。Desktop Extensions 正是为解决这些问题而设计。 架构与打包格式 Desktop Extension 是一个 .mcpb 文件，本质是 ZIP 压缩包。其目录结构包含一个必需的 manifest.json，以及可选的 server/（服务器代码）、dependencies/（依赖库）和 icon.png。文章给出了 Node.js 和 Python 两种示例结构：Node.js 扩展包含 node_modules/ 和 package.json，Python 扩展包含 lib/ 和 requirements.txt。Claude Desktop 内置了 Node.js 运行时，因此用户无需自行安装。 manifest.json 详解 manifest.json 是扩展的唯一必需文件。文章通过三个逐步复杂的示例展示了其…