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

AI 助手 (MCP)

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

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

助手会自行启动服务器;您只需告诉助手服务器在哪里,只需一次。服务器通过其自动化 API 将每个请求传递给此计算机上的应用程序。

助手能做什么

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

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

设置

1. 开启自动化 API

列出和操作下载需要 MDM 的自动化 API,该 API 在您开启之前是关闭的。在 MDM 运行的情况下,运行此命令一次(它会保持开启):

misterdownloadmanager-cli api on

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

2. 查找服务器

misterdownloadmanager-mcp在应用程序旁边:

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

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

3. 告知您的助手

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

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

Claude Code:

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

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

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

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

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

隐私

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

不工作时

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

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

下载 Mister Download Manager