DXT(桌面扩展)开发指南
本文档主要介绍了 DXT (桌面扩展) 的开发指南,它是一种将 MCP 服务器 转换为可分发扩展的工具。文档详述了如何使用 DXT 工具来 初始化、验证和打包 扩展,并提供了 目录结构示例。此外,还强调了在打包 Python 依赖项时需要注意的 跨平台兼容性问题,特别是在不同架构(如 arm64 macOS 与 x86_64 Linux)之间。最终目标是创建一个 .dxt 文件,其中包含所有必需的服务器文件和元数据,以便于分发和管理。

graph TD
A[DXT扩展] -->|打包| B(calculator-mcp-server)
B -->|元数据和配置| C[manifest.json]
B -->|实现| D[server/*.py]
B -->|依赖库| E[server/lib/]
B -->|图标| F[icon.png]
G[MCPHub] -->|运行| H[MCP Servers]
H -->|包含| B
H -->|管理| I[其他 MCP Servers]
J[开发者] -->|开发| B
J -->|使用| K[DXT工具]
K -->|初始化| C
K -->|打包| A
M[用户] -->|上传/安装 DXT扩展| G
P[MCP客户端] -->|调用| G
M[用户] -->|使用| P
style A fill:#f9f,stroke:#333
style G fill:#bbf,stroke:#333
style B fill:#9f9,stroke:#333
style K fill:#ff9,stroke:#333
style P fill:#ccf,stroke:#333
DXT 的核心是包含您的整个 MCP 服务器和 manifest.json 的简单 zip 文件。因此,将本地 MCP 服务器转换为扩展非常直接:您只需将所有必需文件放入一个文件夹,创建一个 manifest.json,然后创建一个压缩包。
DXT 工具
用于构建桌面扩展(Desktop Extensions)的工具。
安装
npm install -g @anthropic-ai/dxt
检查版本
dxt --version
0.2.0
dxt 命令
init [选项] [目录]:创建一个新的 DXT 扩展清单validate <清单文件>:验证 DXT 清单文件pack [目录] [输出文件]:将目录打包成 DXT 扩展unpack <dxt文件> [输出目录]:解压 DXT 扩展文件sign [选项] <dxt文件>:签署 DXT 扩展文件verify <dxt文件>:验证 DXT 扩展文件的签名info <dxt文件>:显示 DXT 扩展文件的信息unsign <dxt文件>:从 DXT 扩展文件中移除签名help [命令]:显示指定命令的帮助信息