Dannex Download Manager
  1. 主页
  2. 帮助
  3. AI 助手 (MCP)

AI 助手 (MCP)

DDM 附带一个 MCP 服务器 dannexdownloadmanager-mcp,因此支持 MCP 的 AI 助手(Claude Desktop、Claude Code、Cursor、VS Code 等)可以与您正在运行的 DDM 中的下载协同工作。您可以用自己的话提问:

  • “DDM 现在正在下载什么,还剩多长时间?”
  • “今晚把 https://example.com/big.iso 下载到 D:\ISOs,暂时不要开始下载。”
  • “暂停所有正在下载的任务。”
  • “从列表中删除已完成的下载,但保留文件。”

助手会自行启动服务器;您只需告诉助手服务器的位置,告诉一次即可。服务器通过其 自动化 API 将每个请求传递给这台电脑上的应用。

助手能做什么

工具 功能
list_downloads 列出您的下载,最新优先:文件、地址、文件夹、状态、大小、已完成百分比、速度。它可以只列出一种状态(排队中、正在下载、已停止、完成、错误),或者只列出包含某些文本的名称和地址。
add_download 添加 http、https、ftp 或 ftps 地址并开始下载,或者只将其排队。它可以指定要使用的文件夹和文件名。磁力链接会在 DDM 中打开添加种子,供您选择文件。
pause_downloads 暂停正在运行的下载。
resume_downloads 开始或恢复已停止、排队中或失败的下载。
remove_downloads 从列表中删除下载并保留其文件,或者在要求时也删除文件。正在运行的下载必须先暂停。
start_queue 启动主下载队列。

助手无法更改 DDM 的选项、查看您的浏览器,也无法自行开启自动化 API。

设置

1. 开启自动化 API

列出和操作下载需要使用 DDM 的自动化 API。开启之前,该 API 处于关闭状态。DDM 运行时,运行此命令一次即可(之后会保持开启):

dannexdownloadmanager-cli api on

dannexdownloadmanager-cli api off再次将其关闭。如果没有 API,助手仍然可以添加下载,与 DDM 的命令行相同。

2. 查找服务器

dannexdownloadmanager-mcp服务器位于应用旁边:

安装方式 服务器位置
Windows,仅限您(安装程序的默认设置) %LOCALAPPDATA%\Programs\Dannex Download Manager\dannexdownloadmanager-mcp.exe
Windows,所有人 C:\Program Files\Dannex Download Manager\dannexdownloadmanager-mcp.exe
Windows,zip 或便携版 dannexdownloadmanager-mcp.exe在其文件夹中
macOS /Applications/Dannex Download Manager.app/Contents/MacOS/dannexdownloadmanager-mcp
Linux,.deb 或 .rpm /usr/bin/dannexdownloadmanager-mcp
Linux,.tar.gz 文件 dannexdownloadmanager-mcp在其所在文件夹中(AppImage 不会显示该文件:请使用 .tar.gz 文件)

便携版服务器会从其自身文件夹中自动找到便携版 DDM。

3. 告知助手

Claude Desktop:设置 → 开发者 → 编辑配置会打开claude_desktop_config.json。添加服务器,然后重启 Claude Desktop:

{
  "mcpServers": {
    "dannexdownloadmanager": {
      "command": "C:\\Users\\you\\AppData\\Local\\Programs\\Dannex Download Manager\\dannexdownloadmanager-mcp.exe"
    }
  }
}

Claude Code:

claude mcp add dannexdownloadmanager -- "C:\Users\you\AppData\Local\Programs\Dannex Download Manager\dannexdownloadmanager-mcp.exe"

Cursor:与 Claude Desktop 相同的mcpServers条目,在~/.cursor/mcp.json中(或在 Cursor 的 MCP 设置中添加)。

VS Code:在.vscode/mcp.json中,或在命令面板中选择MCP: 添加服务器:

{
  "servers": {
    "dannexdownloadmanager": {
      "type": "stdio",
      "command": "C:\\Users\\you\\AppData\\Local\\Programs\\Dannex Download Manager\\dannexdownloadmanager-mcp.exe"
    }
  }
}

使用第 2 步中的路径(在 JSON 中,每个\都写成\\)。其他助手也使用相同的方式:一个启动命令,没有参数。

隐私

DDM 本身仍不会向任何地方发送数据:服务器仅通过受令牌保护的本地通道与此计算机上的 DDM 通信。但助手读取的数据会传递给其自身的 AI 服务:列出下载内容时,下载的文件名、地址和文件夹会发送给该服务,并受该服务隐私条款的约束。如果不希望这样,请关闭自动化 API,或从助手中移除服务器。

不工作时

助手提示 如何操作
Dannex Download Manager 未运行 启动 DDM。服务器无法替您启动 DDM。
自动化 API 已关闭 在 DDM 运行时运行dannexdownloadmanager-cli api on。
DDM 未及时响应 DDM 中可能有窗口正等待您操作(例如问题提示或添加种子);请先处理,然后重试。
DDM 拒绝了请求 DDM 的通道文件来自更早的启动;请重启 DDM。
工具根本没有显示 检查助手设置中的路径,然后重启助手。手动启动时,dannexdownloadmanager-mcp --help会说明其状态。

免费、开源、无广告、无试用版。

下载 Dannex Download Manager