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