Claude Desktop 扩展：一键安装 MCP 服务器

—

去年我们发布模型上下文协议（Model Context Protocol，简称MCP）时，看到开发者们构建了出色的本地服务器，让Claude能够访问从文件系统到数据库的各种资源。但我们不断听到同样的反馈：安装过程过于复杂。用户需要开发者工具，必须手动编辑配置文件，还经常卡在依赖问题上。

今天，我们推出桌面扩展（Desktop Extensions）——一种新的打包格式，让安装MCP服务器变得像点击按钮一样简单。

本地MCP服务器为Claude Desktop用户解锁了强大功能。它们可以与本地应用程序交互、访问私有数据、集成开发工具——同时所有数据都保留在用户自己的机器上。然而，当前的安装过程存在显著障碍：

这些摩擦点意味着，尽管MCP服务器功能强大，但非技术用户基本上无法使用。

桌面扩展（.mcpb文件）通过将整个MCP服务器（包括所有依赖项）打包成一个可安装的软件包来解决这些问题。以下是用户体验的变化：

之前：

之后：

就是这样。无需终端，无需配置文件，没有依赖冲突。

桌面扩展是一个zip归档文件，包含本地MCP服务器以及一个manifest.json，该文件描述了Claude Desktop和其他支持桌面扩展的应用需要了解的一切。

桌面扩展中唯一必需的文件是manifest.json。Claude Desktop负责处理所有复杂性：

清单包含人类可读的信息（如名称、描述或作者）、功能声明（工具、prompt）、用户配置和运行时要求。大多数字段是可选的，因此最小版本非常简短，不过在实践中，我们预计所有三种支持的扩展类型（Node.js、Python和经典二进制/可执行文件）都会包含文件：

清单规范中提供了许多便利选项，旨在让本地MCP服务器的安装和配置更加容易。服务器配置对象可以定义为既支持以模板字面量形式提供的用户自定义配置，也支持平台特定的覆盖。扩展开发者可以详细定义他们希望从用户那里收集哪些配置。

让我们看一个具体示例，了解清单如何辅助配置。在下面的清单中，开发者声明用户需要提供一个api_key。在用户提供该值之前，Claude不会启用该扩展，该值会自动保存在操作系统的密钥保管库中，并且在启动服务器时，${user_config.api_key}会被透明地替换为用户提供的值。类似地，${__dirname}会被替换为扩展解压目录的完整路径。

一个包含大多数字段的完整manifest.json可能如下所示：

要查看扩展和清单示例，请参考MCPB仓库中的示例。

manifest.json中所有必需和可选字段的完整规范，可以在我们的开源工具链中找到。

让我们逐步讲解如何将现有的MCP服务器打包为桌面扩展。我们以一个简单的文件系统服务器为例。

首先，为你的服务器初始化一个清单：

这个交互式工具会询问你的服务器相关信息，并生成一个完整的manifest.json。如果你想快速生成最基本的manifest.json，可以使用--yes参数运行该命令。

如果你的服务器需要用户输入（如API密钥或允许的目录），请在清单中声明：

Claude Desktop将：

在下面的示例中，我们将用户配置作为环境变量传递，但它也可以作为参数传递。

将所有内容打包成一个.mcpb文件：

该命令：

将你的.mcpb文件拖入Claude Desktop的设置窗口。你会看到：

扩展可以适应不同的操作系统：

使用模板字面量处理运行时值：

帮助用户提前了解功能：

我们推出时，Claude Desktop内置了一个精选的扩展目录。用户可以浏览、搜索并一键安装——无需搜索GitHub或审查代码。

虽然我们预计桌面扩展规范以及Claude在macOS和Windows上的实现会随着时间的推移而演变，但我们期待看到扩展以多种创造性的方式被用来扩展Claude的能力。

要提交你的扩展：

我们致力于围绕MCP服务器构建开放生态系统，并相信其被多个应用和服务普遍采用的能力已经惠及社区。基于这一承诺，我们将桌面扩展规范、工具链以及Claude在macOS和Windows上实现自身桌面扩展支持所使用的模式和关键函数开源。我们希望MCPB格式不仅能让本地MCP服务器在Claude上更易于移植，也能惠及其他AI桌面应用。

我们开源的内容包括：

这意味着：

规范和工具链特意标记为0.1版本，因为我们期待与更广泛的社区合作，共同发展和改进这一格式。我们期待听到你的反馈。

我们理解扩展会带来新的安全考量，尤其是对企业用户。在桌面扩展的预览版中，我们内置了多项安全措施：

有关如何在组织内管理扩展的更多信息，请参阅我们的文档。

准备好构建自己的扩展了吗？以下是如何开始：

对于MCP服务器开发者：查阅我们的开发者文档——或者直接在你的本地MCP服务器目录中运行以下命令：

对于Claude Desktop用户：更新到最新版本，并在设置中查找扩展部分

对于企业用户：查看我们的企业文档了解部署选项

在Anthropic内部，我们发现Claude在极少干预的情况下就能很好地构建扩展。如果你也想使用Claude Code，我们建议你简要说明你希望扩展做什么，然后在prompt中添加以下上下文：

桌面扩展代表了用户与本地AI工具交互方式的根本性转变。通过消除安装障碍，我们让强大的MCP服务器对所有人——而不仅仅是开发者——变得触手可及。

在内部，我们正在使用桌面扩展来分享高度实验性的MCP服务器——有些有趣，有些实用。一个团队尝试探索，当模型直接连接到GameBoy时能走多远，类似于我们的"Claude玩宝可梦"研究。我们使用桌面扩展打包了一个单一的扩展，该扩展打开了流行的PyBoy GameBoy模拟器，让Claude能够控制它。我们相信，将模型的能力与用户本地机器上已有的工具、数据和应用程序连接起来，存在无数机会。

我们迫不及待地想看到你的作品。正是同样的创造力为我们带来了成千上万的MCP服务器，现在只需一次点击就能触达数百万用户。准备好分享你的MCP服务器了吗？提交你的扩展以供审核。