Skip to content

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 会自动安全存储并在运行时注入。

构建扩展

构建过程包括四个步骤:

  1. 初始化: 运行 npx @anthropic-ai/mcpb init 生成清单
  2. 配置: 在清单中定义所需的用户输入
  3. 打包: 执行 npx @anthropic-ai/mcpb pack 创建 .mcpb 文件
  4. 测试: 将文件拖入 Claude Desktop 设置中以验证功能

高级功能

扩展支持:

  • 跨平台适配,支持特定操作系统的命令覆盖
  • 动态配置,使用模板字面量实现运行时值
  • 功能声明,预先描述可用的工具和提示词
  • 用户配置,对必需设置进行验证

扩展目录与提交

Anthropic 正在 Claude Desktop 内推出一个精选扩展目录,支持一键发现和安装。开发者在以下操作后可通过表单提交扩展:

  • 遵循提交指南
  • 在 Windows 和 macOS 上测试
  • 通过质量和安全审查

开放生态承诺

公司正在开源:

  • 完整的 MCPB 规范
  • 打包和验证工具
  • 参考实现代码
  • TypeScript 类型和模式

这实现了"一次打包,随处运行"的兼容性,不仅限于 Claude,还支持多个 AI 桌面应用。

安全与企业功能

用户保护包括敏感数据的操作系统密钥链存储和自动更新。企业功能包括:

  • 组策略和 MDM (macOS) 管理
  • 预安装批准的扩展
  • 发布者/扩展黑名单
  • 禁用目录
  • 私有扩展目录

快速开始

开发者应查看开源仓库中的文档并运行初始化命令。桌面用户可以更新 Claude 并访问设置中的扩展部分。企业管理员可以参考部署文档进行组织范围的配置。

创新示例

在内部,Anthropic 使用 Desktop Extensions 打包了 GameBoy 模拟器集成,允许 Claude 直接控制游戏状态——展示了将 AI 能力连接到本地工具和应用的潜力。