# @anthropic-ai/dxt 中文文档

规范地址：https://npmcn.com/package/%40anthropic-ai/dxt/

版本：0\.2\.6
npm 元数据更新时间：2026-10-07T17:13:43.394Z
中文译文更新时间：2026-11-06T06:39:30.640Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40anthropic-ai/dxt
原文对照：https://npmcn.com/package/%40anthropic-ai/dxt/?lang=original

弃用说明：This package has been renamed to @anthropic-ai/mcpb

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：169 kB，39 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：8 个
- 首次发布：2025-06-26T15:53:19.742Z
- 最新版本发布：2025-07-20T21:15:58.250Z
- 近 30 天下载量：5293（2026-10-06 至 2026-11-04，npm 官方下载统计）
- 已发布版本数：8（近 12 个月 0 个）

## 中文简介

用于构建桌面扩展的工具

## 安装

```sh
npm install @anthropic-ai/dxt
```

也可以使用：`pnpm add @anthropic-ai/dxt`、`yarn add @anthropic-ai/dxt`、`bun add @anthropic-ai/dxt`

## README

# 桌面扩展 (DXT)

桌面扩展( E)`.dxt`包含一个本地 MCP 服务器和一个 `manifest.json` 描述服务器及其能力。 格式在精神上与Chrome扩展(`.crx`)或VS代码扩展(`.vsix`),使终端用户能够用一击就安装本地的MCP服务器.

该储存库提供三个组成部分: 扩展规格 [MANIFEST.md (英语)](https://npmcn.com/package/%40anthropic-ai/dxt/MANIFEST.md),用于创建扩展的 CLI 工具(见 [CLI.m.d (中文(简体) )](https://npmcn.com/package/%40anthropic-ai/dxt/CLI.md)),以及克洛德用于macOS和Windows的代码来加载和验证DXT扩展(英语:[标准/指数.ts](https://npmcn.com/package/%40anthropic-ai/dxt/src/index.ts)) (中文(简体) ).

-   对于本地MCP服务器的开发者,我们的目标是方便上述服务器的分发和安装
-   对于支持本地 MCP 服务器的应用软件开发者,我们的目标是方便添加对 DXT 扩展的支持

Claude for macOS和Windows使用这个寄存器中的代码来实现对本地MCP服务器的单击安装,包括一些端端用户友好的功能——如自动更新,MCP服务器的简单配置以及它们所需要的变量和参数,以及一个被整理的目录. 我们致力于MCP服务器周围的开放生态系统,并相信其被多应用程序和服务普遍采用的能力使开发者受益,旨在将AI工具与其他应用程序和服务连接起来. 因此,我们正在开放桌面扩展规格、工具链、以及克劳德用于macOS和Windows的策略和关键功能,以落实其对桌面扩展的支持。 我们希望 `dxt` 不仅让本地的MCP服务器更适合克劳德.

# 用于扩展开发者

在核心,DXT是简单的zip文件,包含您所有的MCP服务器和一个 `manifest.json`因此,将本地的 MCP 服务器变成扩展是直截了当的: 您只需要将所有所需的文件放入文件夹, 创建 `manifest.json`,然后创建一个归档.

为了方便这一过程,这个软件包提供了一个CLI, 帮助您创建两个 `manifest.json` 和最后决定 `.dxt` 文档。 要安装, 请运行 :

```sh
npm install -g @anthropic-ai/dxt
```

1.  在包含您本地 MCP 服务器的文件夹中运行 `dxt init`。此命令将引导您创建 `manifest.json`。 。 。 .
2.  运行 `dxt pack` 创建 `dxt` 文档.
3.  现在,任何用于DXT的应用程序执行支持都可以运行您本地的MCP服务器. 例如,用克洛德打开文件让macOS和Windows显示安装对话框.

您可以找到全部的光谱 `manifest.json` 及其所有强制性和任择性领域 [MANIFEST.md (英语)](https://npmcn.com/package/%40anthropic-ai/dxt/MANIFEST.md)。扩展示例可见于 [实例](https://npmcn.com/package/%40anthropic-ai/dxt/examples/)。 。 。 .

## AI 工具的提示模板

Claude Code等AI工具在得知光谱后特别擅长创建桌面扩展. 当提示一个 AI 编码工具来构建扩展时, 请简要解释您的扩展要做什么 - 然后在您的指令中加入以下上下文 .

> 我想把这个建为桌面扩展,缩写为"DXT". 请遵循这些步骤:
> 
> 1.  **详细阅读规格:**
>     -   [https://github.com/ 人类学/dxt/blob/main/README.md](https://github.com/anthropics/dxt/blob/main/README.md) - DXT结构概述、能力和整合 模式
>     -   [https://github.com/ 人类学/dxt/blob/main/MNIFEST.md](https://github.com/anthropics/dxt/blob/main/MANIFEST.md) - 完整的扩展显示结构和实地定义
>     -   [https://github.com/ 人类学/dxt/tree/main/examples. 中国植物物种信息数据库](https://github.com/anthropics/dxt/tree/main/examples) - 参考执行,包括“你好世界”实例
> 2.  **创建合适的扩展结构 :**
>     -   生成一个有效的列表
>     -   使用 @ modelcontextprotocol/ sdk 安装 MCP 服务器, 并有适当的工具定义
>     -   包括适当的错误处理、安全措施和超时管理
> 3.  **遵循最佳发展做法:**
>     -   通过 stdio 运输执行适当的 MCP 协议通信
>     -   具有明确计划、验证和一致的JSON反应的结构工具
>     -   利用这个扩展将在当地运行这一事实
>     -   添加适当的记录和调试能力
>     -   包含适当的文档和设置指令
> 4.  **测试考虑:**
>     -   验证所有工具调用返回结构合理的响应
>     -   正确验证显示的负载和主机集成工程
> 
> 生成完整的,生产准备的代码,可以立即测试. 注重防御编程,明确出错信息,并遵循精确的DXT规格,以确保与生态系统相容.

## 目录结构

### 最小扩展

A 类 `manifest.json` 是唯一需要的文件.

### 示例:节点.js扩展

```
extension.dxt (ZIP file)
├── manifest.json         # Required: Extension metadata and configuration
├── server/               # Server files
│   └── index.js          # Main entry point
├── node_modules/         # Bundled dependencies
├── package.json          # Optional: NPM package definition
├── icon.png              # Optional: Extension icon
└── assets/               # Optional: Additional assets
```

### 示例: Python 扩展

```
extension.dxt (ZIP file)
├── manifest.json         # Required: Extension metadata and configuration
├── server/               # Server files
│   ├── main.py           # Main entry point
│   └── utils.py          # Additional modules
├── lib/                  # Bundled Python packages
├── requirements.txt      # Optional: Python dependencies list
└── icon.png              # Optional: Extension icon
```

### 示例: 二进制扩展

```
extension.dxt (ZIP file)
├── manifest.json         # Required: Extension metadata and configuration
├── server/               # Server files
│   ├── my-server         # Unix executable
│   ├── my-server.exe     # Windows executable
└── icon.png              # Optional: Extension icon
```

### 附属物

**Python 扩展 :**

-   装入所有需要的软件包 `server/lib/` 目录
-   OR 捆绑完整的虚拟环境 `server/venv/`
-   使用工具,如 `pip-tools`, (中文(简体) ), `poetry`,或 `pipenv` 以创建可复制的捆绑
-   设定 `PYTHONPATH` 以通过 `mcp_config.env`

**节点.js 扩展:**

-   运行 `npm install --production` 创建 `node_modules`
-   包起来 `node_modules` 带有扩展名的目录
-   使用 `npm ci` 或者说 `yarn install --frozen-lockfile` 可复制建筑
-   在 Express.json 中指定的服务器入口 `server.entry_point`

**二进制扩展名 :**

-   为最大兼容性选择的静态链接
-   如果使用动态链接, 包含所有需要共享的库
-   没有发展工具的清洁系统测试

## 常见问题

### @anthropic-ai/dxt 是什么？

用于构建桌面扩展的工具注意：该包已被作者标记为弃用——This package has been renamed to @anthropic-ai/mcpb

### 如何安装 @anthropic-ai/dxt？

在项目目录运行 npm install @anthropic-ai/dxt，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 dxt，可以用 npx dxt 直接运行。

### @anthropic-ai/dxt 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @anthropic-ai/dxt 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @anthropic-ai/dxt 可以商用吗？

@anthropic-ai/dxt 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @anthropic-ai/dxt 的下载量有多少？

根据 npm 官方下载统计，@anthropic-ai/dxt 在 2026/10/06 – 2026/11/04 这 30 天内被下载 5,293 次，日均约 176 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @anthropic-ai/dxt 还在维护吗？

最新版本 0\.2\.6 发布于 2025/07/21（1\.3 年前）；至今共发布 8 个版本，其中过去 12 个月发布了 0 个；首次发布于 2025/06/26。作者已将其标记为弃用，新项目建议寻找替代方案。