Desktop Extensions (DXT) 详解

原创 已于 2025-07-18 22:55:17 修改 · 2k 阅读 · 17 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。
文章标签：

#dxt #ai #mcp #AIGC #agent

于 2025-07-14 22:58:59 首次发布

Desktop Extensions (DXT) 详解

什么是Desktop Extensions (DXT)？

Desktop Extensions (DXT，桌面扩展) 是一种用于打包和分发本地MCP (Model Context Protocol) 服务器的标准化格式。它类似于Chrome扩展(.crx)或VS Code扩展(.vsix)，允许用户通过单次点击安装本地MCP服务器。

Desktop Extensions​https://www.anthropic.com/engineering/desktop-extensions

DXT的核心是一个包含以下内容的ZIP压缩包： - 完整的本地MCP服务器代码/二进制文件 - 描述扩展功能和配置的manifest.json文件 - 其他资源文件（如图标、配置文件等）

DXT的主要特点

特点 (Feature)描述 (Description)优势 (Advantage)
单文件分发 (Single-file distribution)所有内容打包在一个.dxt文件中简化安装和分发过程
标准化配置 (Standardized configuration)通过manifest.json定义服务器配置消除手动配置错误
跨平台支持 (Cross-platform support)支持Node.js、Python和二进制服务器开发者可自由选择技术栈
用户配置集成 (User configuration integration)内置用户配置系统提供统一的配置界面
自动更新 (Automatic updates)支持扩展版本管理和更新确保用户使用最新版本

DXT使用方法

1. 安装CLI工具

npm install -g @anthropic-ai/dxt

2. 创建扩展

# 初始化新扩展
dxt init my-extension
cd my-extension

# 开发你的MCP服务器代码
# (根据选择的服务器类型创建相应文件)

# 打包扩展
dxt pack . my-extension.dxt

3. 签名扩展（可选）

# 自签名扩展（开发用途）
dxt sign my-extension.dxt --self-signed

# 使用正式证书签名
dxt sign my-extension.dxt --cert cert.pem --key key.pem

4. 安装使用

生成的.dxt文件可直接在支持DXT格式的应用程序中安装使用。由于所有文件已预先打包，安装过程仅需解压即可。

Manifest定义详解

基本结构

{
  "dxt_version": "0.1",
  "name": "my-extension",
  "version": "1.0.0",
  "description": "A simple MCP extension",
  "author": {
    "name": "Extension Author"
  },
  "server": {
    "type": "node",
    "entry_point": "server/index.js",
    "mcp_config": {
      "command": "node",
      "args": ["${__dirname}/server/index.js"]
    }
  }
}

关键字段说明

1. 元数据部分 (Metadata)

字段 (Field)类型 (Type)必填 (Required)描述 (Description)
dxt_versionstring是DXT规范版本
namestring是扩展的唯一标识名称
versionstring是语义化版本号
descriptionstring是简短描述
authorobject是作者信息

2. 服务器配置 (Server Configuration)

"server": {
  "type": "python",
  "entry_point": "server/main.py",
  "mcp_config": {
    "command": "python",
    "args": ["server/main.py"],
    "env": {
      "PYTHONPATH": "server/lib",
      "API_KEY": "${user_config.api_key}"
    },
    "platform_overrides": {
      "win32": {
        "command": "python.exe"
      }
    }
  }
}

这里定义了服务端的核心配置，其中mcp_config部分是与 MCP 兼容的实际运行时配置，而外层的type和entry_point字段提供了更抽象的接口定义，为未来可能的扩展保留了灵活性。两者内容本质上是相关的，但外层配置提供了更高层次的抽象。

服务器类型支持：

  • node: Node.js服务器
  • python: Python服务器
  • binary: 预编译二进制

3. 用户配置 (User Configuration)

"user_config": {
  "api_key": {
    "type": "string",
    "title": "API Key",
    "description": "Your API key for authentication",
    "sensitive": true,
    "required": true
  },
  "max_file_size": {
    "type": "number",
    "title": "Maximum File Size (MB)",
    "description": "Maximum file size to process",
    "default": 10,
    "min": 1,
    "max": 100
  }
}

配置类型支持：

  • string: 文本输入
  • number: 数字输入
  • boolean: 复选框/开关
  • directory: 目录选择器
  • file: 文件选择器

directory 和 file 在实际类型定义里，其实是 string | string[ ] 。所以可以通过 multiple 参数来控制配置一个或者多个可访问的路径或者文件。

4. 工具和提示定义 (Tools and Prompts)

"tools": [
  {
    "name": "search_files",
    "description": "Search for files in a directory"
  }
],
"prompts": [
  {
    "name": "explain_code",
    "description": "Explain how code works",
    "arguments": ["code", "language"],
    "text": "Explain this ${arguments.language} code:\n${arguments.code}"
  }
],
"tools_generated": true,
"prompts_generated": false

实际应用示例

文件搜索扩展示例

{
  "dxt_version": "0.1",
  "name": "file-search",
  "display_name": "File Search Extension",
  "version": "1.0.0",
  "description": "Allows searching files in specified directories",
  "author": {
    "name": "Search Tools Inc.",
    "email": "support@searchtools.com"
  },
  "server": {
    "type": "node",
    "entry_point": "server/index.js",
    "mcp_config": {
      "command": "node",
      "args": ["${__dirname}/server/index.js"],
      "env": {
        "SEARCH_PATHS": "${user_config.search_dirs}"
      }
    }
  },
  "user_config": {
    "search_dirs": {
      "type": "directory",
      "title": "Search Directories",
      "description": "Directories to include in searches",
      "multiple": true,
      "required": true,
      "default": ["${HOME}/Documents"]
    },
    "max_depth": {
      "type": "number",
      "title": "Maximum Search Depth",
      "description": "How many subdirectory levels to search",
      "default": 3,
      "min": 1,
      "max": 10
    }
  },
  "tools": [
    {
      "name": "search_files",
      "description": "Search for files by name or content"
    },
    {
      "name": "get_file_info",
      "description": "Get information about a file"
    }
  ],
  "compatibility": {
    "claude_desktop": ">=1.2.0",
    "platforms": ["darwin", "win32", "linux"],
    "runtimes": {
      "node": ">=16.0.0"
    }
  }
}

以上是一个 manifest.json 文件的完整配置示例，供大家参考。

总结

Desktop Extensions (DXT，桌面扩展) 是一种创新的本地MCP服务器打包和分发格式，具有以下核心优势：

  1. 简化分发：将复杂配置封装为单文件，实现一键安装
  2. 标准化接口：通过manifest.json明确定义服务器能力和配置需求
  3. 跨平台支持：兼容Node.js、Python和二进制等多种服务器类型
  4. 用户友好：内置配置系统提供统一的用户界面
  5. 生态系统集成：支持工具和提示的声明，便于AI应用集成

DXT特别适合需要与桌面AI应用集成的本地服务场景，如：

  • 文件系统访问工具
  • 本地数据库查询接口
  • 专业软件集成插件
  • 自定义自动化工具

通过标准化和简化本地MCP服务器的分发流程，DXT有望成为AI桌面应用生态系统中重要的组成部分。

上手开发 DXT

关于 DXT 的使用操作，网上已有大量演示。今天我们将重点讲解如何利用官方 GitHub 库进行开发。

Anthropics DXThttps://github.com/anthropics/dxt

DXT 库主要提供了用于创建和打包 DXT 文件的接口，并且提供解压缩已打包的 DXT 文件并转换为 MCP server 的功能。

现有的解压缩和转换接口

1. 核心配置转换接口

库中提供了 getMcpConfigForManifest 函数，这是将 DXT 扩展转换为 MCP server 配置的核心接口： config.ts:

export async function getMcpConfigForManifest(
  options: GetMcpConfigForManifestOptions,
): Promise<McpServerConfig | undefined>

该函数的主要功能包括：

  const baseConfig = manifest.server?.mcp_config;
  if (!baseConfig) {
    return undefined;
  }
  • 处理平台特定的配置覆盖:
  if (baseConfig.platform_overrides) {
    if (process.platform in baseConfig.platform_overrides) {
      const platformConfig = baseConfig.platform_overrides[process.platform];

      result.command = platformConfig.command || result.command;
      result.args = platformConfig.args || result.args;
      result.env = platformConfig.env || result.env;
    }
  }
  • 执行变量替换，包括 ${__dirname}、${user_config.*} 等:
  const variables: Record<string, string | string[]> = {
    __dirname: extensionPath,
    pathSeparator,
    "/": pathSeparator,
    ...systemDirs,
  };

  // Build merged configuration from defaults and user settings
  const mergedConfig: Record<string, unknown> = {};

  // First, add defaults from manifest
  if (manifest.user_config) {
    for (const [key, configOption] of Object.entries(manifest.user_config)) {
      if (configOption.default !== undefined) {
        mergedConfig[key] = configOption.default;
      }
    }
  }

  // Then, override with user settings
  if (userConfig) {
    Object.assign(mergedConfig, userConfig);
  }

  // Add merged configuration variables for substitution
  for (const [key, value] of Object.entries(mergedConfig)) {
    // Convert user config to the format expected by variable substitution
    const userConfigKey = `user_config.${key}`;

    if (Array.isArray(value)) {
      // Keep arrays as arrays for proper expansion
      variables[userConfigKey] = value.map(String);
    } else if (typeof value === "boolean") {
      // Convert booleans to "true"/"false" strings as per spec
      variables[userConfigKey] = value ? "true" : "false";
    } else {
      // Convert other types to strings
      variables[userConfigKey] = String(value);
    }
  }

2. 变量替换系统

DXT 系统支持多种变量替换，用于将打包的扩展适配到运行时环境： MANIFEST.md

支持的变量包括：

  • ${__dirname}: 扩展目录的绝对路径
  • ${HOME}, ${DESKTOP}, ${DOCUMENTS}, ${DOWNLOADS}: 系统目录
  • ${user_config.*}: 用户配置值
  • ${pathSeparator} 或 ${/}: 路径分隔符

架构分析

DXT 到 MCP Server 的转换流程

所以对于一个Desktop MCP Client 应用，典型的实现流程应当包括：

  1. 接收 .dxt 文件
  2. 解压缩 ZIP 档案
  3. 验证数字签名
  4. 解析 manifest.json
  5. 使用 getMcpConfigForManifest 生成 MCP 配置
  6. 启动 MCP server 进程

开源实现

由于 Claude Desktop 本身是闭源的，所以无法获知它的实际实现方式，所以我在我自己的开源项目 TUUI 中完整实现了一遍，这里提供一下使用效果：

配置界面需要配置允许访问的目录

file-system-node 默认提供了一系列用于访问本地路径的工具

LLM 自动编排工具调用来完成文件夹的访问和文件的写入

最后保持好习惯，所有代码都开源到了github：

https://www.github.com/AI-QL/tuui

对于 Window 系统的小伙伴，可以安装 nodejs 之后，直接在最新 release 中下载 zip 免安装包和对应的两个 .dxt 文件示例来体验（注意：其中 file-system-node.dxt 这个官方包的 Allowed Directory 实际是个必须配置的参数。所以需要配置之后才能正常启动 MCP Server）

对于 MacOS 的小伙伴，就比较麻烦了，我在 README 中给出了一些 ISSUE 链接，需要魔改一下 node 的安装访问路径。由于对应的问题在开源社区还是 open 状态，所以我暂时也只能保持现状，等有了较为明确的结论再调试这部分。

好了，以上就是今天的内容，睡觉去了，又要秃了。。。。

Unable to load extension: pydevd_plugins.extensions.types.pydevd_plugin_pandas_types 解决方案
weixin_43178406的博客
11-17 9万+
本文主要介绍了在运行jupyter notebook时报错Unable to load extension: pydevd_plugins.extensions.types.pydevd_plugin_pandas_types解决方案，希望能对新手有所帮助。 文章目录 1. 问题描述 2. 解决方案
RuntimeError Cuda extensions are being compiled...Pytorch binaries were compiled with Cuda 11.7解决方案
热门推荐
weixin_43178406的博客
07-09 6万+
本文主要介绍了RuntimeError: Cuda extensions are being compiled with a version of Cuda that does not match the version used to compile Pytorch binaries. Pytorch binaries were compiled with Cuda 11.7解决方案，希望能对使用Pytroch的同学们有所帮助。 文章目录 1. 问题描述 2. 解决方案
dxt：为本地MCP服务器安装带来革命性便捷
gitblog_00620的博客
06-27 565
dxt（Desktop Extensions）是一种全新的格式，它将本地MCP（Model Context Protocol）服务器与一个描述服务器及其能力的`manifest.json`文件打包在一起。这种格式灵感来源于Chrome扩展（`.crx`）或VS Code扩展（`.vsix`），使得最终用户能够通过单次点击轻松安装本地MCP服务器。 本项目提供了三个主要组件：扩展规范（`MANIF...
关于DDS文件格式的说明
gogoda的专栏
06-21 2652
DDS文件格式要追述到S3(Silicon & Software Systems)公司提出的一种纹理压缩格式S3TC(S3 Texture Compression), 其目的是通过对纹理的压缩, 以达到节约系统带宽并提高效能的目的. S3TC就是通过压缩方式, 利用有限的纹理缓存空间来存储更多的纹理, 因为它支持6:1的压缩比例, 所以6M的纹理可以被压缩为1M存放在材质缓存中, 从而在节约了缓存
纹理压缩格式DXT/PVR/ETC编码
春夜喜雨的专栏
05-07 4075
DXT格式常位于的.DDS文件中，常见的格式有DXT1, DXT3, DXT5：也即BC1/BC2/BC3。 DXT1表达RGB色，不带mipmap情况，平均4Bit/像素-4BPP； DXT3/DXT5表达RGBA色，8BPP。
DXT纹理压缩
lhc717的专栏
09-23 2万+
我们知道游戏中对于3D物体表面细节的表现最重要的还是靠贴图来实现的，那么越是高分辨率越是真彩色的贴图自然表现力也是越强，但是同时带来的问题是所需占用的内存会成倍的上升，而节省内存这一点在目前的游戏中还是非常非常重要的。 所以各个平台上都在使用纹理压缩的技术，让纹理贴图在内存占
Unity纹理压缩格式DXT，ETC，ASTC
m0_56156989的博客
08-11 2576
PC端：DXTIOS：ASTC。
纹理压缩简介 DXT PVR ETC
大猪的博客
03-22 2278
在软件开发，特别是三维应用中，纹理随处可见，但受限于网络环境和硬件能力，纹理也是一大瓶颈。而且在一般的三维应用中，纹理所占大小基本都会在1/2以上，模型中往往超过2/3。或许你会说，纹理不就是一张图吗，有那么重要吗？如下两张对比图，可能你会认为前者逼格高，但对于正常人而言，后者显然要好很多。正是有了纹理，如同在骨架上赋予了皮肤，让我们的应用更加的逼真，贴近现实。 而你能想象到吗？...
精选资源
gitextensions-3.5.4.zip
05-20
gitextensions-3.5.4.zip
GitExtensions2.49.03安装包支持VS2008至VS2015
06-28
资源下载链接为： https://pan.quark.cn/s/1bfadf00ae14 GitExtensions-2.49.03-SetupComplete.msi 这个安装包适用于从 Visual Studio 2008 到 Visual Studio 2015 的版本。
Docker Desktop 安装问题解决方案
Realm_021502的博客
07-13 826
Docker Desktop 安装方法以及 安装问题的解决方法
DXT 图片压缩(DXTC/DirectX Texture Compression Overview)
weixin_30437847的博客
07-22 778
这两天在写 DDS 格式的解码程序。DDS 是微软为 DirectX 开发的一种图片格式，MSDN 上可以查到其文件格式说明：http://msdn2.microsoft.com/en-us/library/bb172993.aspx其中的 DXT 图片压缩格式，现在已经为绝大多数 3D 显卡硬件所支持。（它使用了由 S3 公司所发明的一种有损图象压缩算法。btw, 在我的那本书中，P232 有...
DDS文件格式
自由理想的足迹
05-03 1万+
DX中开发的游戏DDS是首选，就类似ios中的pvr格式一样强大，因为那是显卡支持的。 一、DX下DDS文件的优点： 1.cpu上运算速度快，不需要解析为RGB数据就可以直接由DX函数加载提交给显卡渲染贴图。 2.内存占用少效率高，因为不需要创建临时的内存来存放解析的数据，所以避免了内存和申请释放和内存飙升。 3.压缩效率高，通过更少为位数有损压缩，但是画质也非常好，压缩效
游戏进度：关于DirectX3D的压缩纹理格式DXT1/CB1
weixin_44202285的博客
11-07 1470
DXT1/BC1，DirectX3D
【AIGC】即梦omnihuaman-api调用实现
qq_44091004的博客
12-18 972
摘要：该项目是基于火山引擎即梦API的数字人视频生成Demo，支持图片+音频驱动生成数字人视频。核心功能包括AK/SK在线填写、图片/音频上传、主体检测与Mask选择、Prompt控制、视频生成与下载等。运行环境要求Python≥3.9和可公网访问的静态文件服务。项目提供了完整的配置指南和使用流程，适用于技术演示、API调用示例和二次开发基础。注意事项包括使用清晰正脸图像、控制音频时长等。项目开源地址已提供，并声明仅为API使用示例，效果以官方为准。
从工具使用者到创作工程师：AIGC创作流程优化的技术实践
2501_92440658的博客
12-18 786
第一步：收集和分析参考风格# 初始化风格管理器# 分析风格特征print(f"识别到风格特征: {style_features['key_characteristics']}")# 基于风格优化基础参数# 根据风格调整参数print(f"优化后的参数: {optimized_params}")可重复性：确保相同质量的输出可以重复获得可扩展性：能够处理从单张到大规模系列的创作需求可优化性：每个环节都可以基于数据进行持续优化可协作性：系统化流程便于团队协作和知识传递。
AIGC 商用实战派：集之互动用 “高可控” 接住品牌真需求
zhijieqianyan的博客
12-16 297
例如，一只鞋子在镜头移动中突然鞋带消失，或者原本设定的“清晨阳光”变成了“黄昏余晖”，这些对于通用模型来说是常见的“发挥”，但对于广告主来说却是绝对的“红线”。集之互动展现出的技术深度证明了：AI视频生成的未来，不属于那些只会“生成”的工具，而属于那些能够“控制”的平台。通过基于国家备案的自研“无垠大模型”与广告场景专属控制算法，集之互动成功破解了AI视频的“幻觉”难题，将“随机的艺术”变成了“可控的工业”。对于整个行业而言，这标志着AI视频技术终于跨过了商业化的门槛，迎来了真正的“实战时代”。
集之互动AIGC广告大片：以“高可控”技术重构品牌视觉想象
最新发布
zhijieqianyan的博客
12-19 419
无论是需要契合特定营销节点的主题广告，还是突出产品核心卖点的宣传大片，集之互动的技术底座都能提供稳定可靠的创作支持，让每一次生成都能贴合品牌的创作诉求，让每一帧画面都真正由品牌方掌控。针对通用AIGC技术普遍存在的“幻觉”问题，集之互动通过专项算法优化与大量行业数据训练，形成了有效的规避机制这种全方位的“高可控”能力，让生成的内容完全符合商业广告的生产标准，既保证了画质的高清质感，又确保了内容的合规性，彻底打破了品牌方对AI创意不可控的焦虑，让品牌能够全程主导广告创作方向，实现创意构想的落地。
告别“开盲盒”式创作，集之互动“高可控”AIGC创意视频
zhijieqianyan的博客
12-19 211
集之互动通过专项技术研发，对这一行业痛点进行了针对性破解。同时，通过对品牌核心价值、发展理念、产品卖点的深度解码，以及对目标受众的消费习惯、沟通语境、情感需求的细致分析，让AI生成的内容不仅仅是视觉层面的呈现，更能传递品牌的核心主张，引发目标受众的情感共鸣。集之互动的AIGC创意视频解决方案，并非局限于“单次合作、交付成片”的短期服务模式，而是致力于通过“服务+培训+定制系统”的全栈模式，为企业提供长期的赋能支持，帮助企业实现AI广告能力的内化，从“依赖外部合作”走向“自主生产”的可持续发展阶段。
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值