Model Context Protocol · 2024-11-05 · stdio

让 AI 助手直接驱动 unfetch 下载引擎

unfetch 二进制自身即内置完整的 MCP Server(--mcp),暴露 17 个工具、task://{id} 资源实时订阅以及 4 个 Claude Skills —— Claude Desktop、Claude Code、Cursor、Codex 等任意 MCP 宿主均可零配置调用。

方式一:Claude Code 插件一键安装(MCP + 4 Skills)

Recommended

在 Claude Code 中运行以下两条命令,即可同时安装 unfetch MCP Server 与全套 4 个下载 Skills:

/plugin marketplace add guangtoutong/unfetch
/plugin install unfetch@unfetch

方式二:Claude Desktop / Cursor / 通用 MCP 配置

将以下配置加入 claude_desktop_config.json 或 .mcp.json:

{
  "mcpServers": {
    "unfetch": {
      "command": "/Applications/unfetch.app/Contents/MacOS/unfetch",
      "args": ["--mcp"]
    }
  }
}
{
  "mcpServers": {
    "unfetch": {
      "command": "C:\\Program Files\\unfetch\\unfetch.exe",
      "args": ["--mcp"]
    }
  }
}
{
  "mcpServers": {
    "unfetch": {
      "command": "unfetch",
      "args": ["--mcp"]
    }
  }
}

17 个内置 MCP 工具

add_task req: url
添加下载任务 —— 支持多镜像 HTTP/S、FTP/FTPS/SFTP、BT 磁力/种子、ed2k 及 1000+ 视频网站
detect_url req: url
检测下载链接所属协议与引擎类型(http / ftp / bt / ed2k / ytdlp)
preview_torrent req: url
预览磁力或种子内的文件列表(返回文件名、大小与下标,用于按需选择下载)
wait_for_task req: id
阻塞等待单个任务完成或失败,期间持续推送 notifications/progress 实时进度
wait_for_all
阻塞等待当前所有活动任务全部下载完成或超时
list_tasks
列出下载任务(支持按状态过滤:all / downloading / paused / done / error / queued)
get_task req: id
获取单个任务的详细进度、速度、剩余时间、Peer 统计与哈希校验结果
pause_task req: id
暂停正在下载或排队的任务
resume_task req: id
从断点恢复已暂停或失败的任务
remove_task req: id
彻底删除任务(可传 delete_file: true 同时删除本地文件)
trash_task req: id
将任务移入回收站(可恢复,不删除已下载数据)
restore_task req: id
从回收站恢复单个任务
empty_trash
清空回收站(彻底删除回收站内所有任务及对应本地文件)
restore_all_trashed
一键恢复回收站内的全部任务
get_config
读取当前 Daemon 配置(下载目录、线程数、限速、代理等)
set_config
热更新配置项(下载目录、并发数、线程数、全局限速、完成动作等)
play_in_unflick req: path
调用 Unflick 播放器直接播放已下载的媒体文件

4 个配套 AI Skills

unfetch-grab

单链接智能下载:自动探测协议、哈希校验并等待完成回报

unfetch-batch

批量链接队列编排、多镜像并发加速与前置任务依赖链

unfetch-media

1000+ 视频网站音视频抓取,支持画质与纯音频选择

unfetch-watch

下载队列实时监控、慢速任务诊断与回收站清理

典型提示词示例

「帮我把这个 4K 视频下到 ~/Downloads,画质选 1080p,下完自动用 Unflick 播放」
「先预览这个磁力链接里的文件列表,只勾选最大的 mp4 视频和 .srt 字幕文件开始下载」
「我有几个正在进行的下载?把大于 2 GB 的任务暂停,晚上 23:00 再定时恢复」