DXT

DXT 是一种用于封装本地 MCP 服务器及其配置信息的打包格式。它本质上是一个 ZIP 文件，包含一个描述扩展元信息的 manifest.json 文件和完整的 MCP 服务器代码。这种结构类似于 Chrome 的 .crx 或 VS Code 的 .vsix 扩展格式，支持用户通过单次点击完成本地 MCP 服务器的安装。

本项目提供以下三部分核心内容：

• 扩展规范：定义了 DXT 扩展的文件结构与字段含义（详见 MANIFEST.md）。
• 命令行工具（CLI）：帮助开发者快速创建和打包 DXT 扩展（详见 CLI.md）。
• 客户端实现代码：Claude for macOS 和 Windows 使用该仓库中的代码实现对 DXT 扩展的支持（位于 src/index.ts）。

该项目的目标是提升本地 MCP 服务器的可移植性和集成效率，降低开发者和用户的使用门槛。

对本地 MCP 服务器开发者

如果你正在开发本地 MCP 服务器，DXT 提供了一种标准化的分发方式。你可以将整个服务打包为一个 .dxt 文件，用户只需一次点击即可完成安装和配置。你无需额外开发复杂的安装流程，也无需担心环境依赖问题。

要创建一个 DXT 扩展，只需将你的 MCP 服务器文件放入一个目录中，并添加一个符合规范的 manifest.json 文件，最后使用 CLI 工具将其打包为 .dxt 文件即可。

我们提供了专门的命令行工具来简化这一过程：

npm install -g @anthropic-ai/dxt

进入包含 MCP 服务器的目录后，执行以下命令：

dxt init # 创建 manifest.json 文件
dxt pack # 打包为 .dxt 文件

此时，任何支持 DXT 格式的应用都可以加载并运行你的 MCP 服务器。例如，在 Claude for macOS 和 Windows 中打开 .dxt 文件将自动弹出安装提示。

详细的 manifest.json 字段说明请参阅 MANIFEST.md，示例项目可在 examples 目录 中找到。

对应用程序开发者

如果你正在开发支持本地 MCP 服务器的应用程序，DXT 提供了一个轻量且灵活的集成方案。你只需实现对 .dxt 文件的解析和加载逻辑，即可让用户直接安装和管理本地 AI 工具。

目前，Claude for macOS 和 Windows 已基于此项目实现了完整支持，包括：

• 自动更新机制
• 简洁的配置界面，便于设置 MCP 服务器参数
• 支持精选扩展目录展示

我们希望通过开源 DXT 规范、工具链以及相关实现代码，推动更多应用加入对本地 MCP 服务器的支持，构建一个开放的 AI 工具生态系统。

利用 AI 工具生成 DXT 扩展

AI 编码助手（如 Claude Code）在了解 DXT 规范后，可以高效地协助开发者创建扩展。如果你希望借助 AI 构建 DXT 扩展，请参考以下指导步骤：

准备阶段

请 AI 阅读以下文档以确保理解 DXT 结构和要求：

• DXT 架构与功能说明
• manifest.json 完整字段定义
• 示例扩展项目

开发流程

1. 结构搭建
   • 根据 MANIFEST.md 创建有效的 manifest.json
   • 使用 @modelcontextprotocol/sdk 实现 MCP 服务器及所需工具接口
   • 包含必要的错误处理、安全控制和超时机制
2. 编码实践
   • 基于 stdio 实现 MCP 协议通信
   • 工具设计应具备清晰架构、严格验证和一致的 JSON 响应
   • 充分利用本地运行特性，优化性能与交互体验
   • 添加日志记录与调试支持，方便后续排查问题
   • 提供完整文档与安装说明
3. 测试与验证
   • 确保所有工具调用返回结构正确的响应
   • 验证 manifest.json 正确加载，主机集成无误

输出要求

请输出完整、可运行的生产级代码。注重防御性编程，提供清晰的错误提示，并严格遵循 DXT 规范，以确保其能在各类支持 DXT 的应用中正常运行。