FluxDown MCP — 让 AI Agent 用自然语言管理下载
MCP 是什么
Model Context Protocol(MCP)是 Anthropic 提出的一个协议——让 AI 助手(Claude Desktop、Cursor、Trae、VS Code Copilot 等)能够通过标准化的接口调用本地工具。FluxDown 在 http://127.0.0.1:17800/mcp 上实现了 MCP server,这样你就可以让 AI 帮你管下载。
配置方式
不同 AI 助手的配置方式略有不同,但都是填 MCP server 的 URL 和 token。
Claude Desktop
claude_desktop_config.json 里:
{
"mcpServers": {
"fluxdown": {
"url": "http://127.0.0.1:17800/mcp",
"headers": { "Authorization": "Bearer <access_key>" }
}
}
}
Cursor
设置 → Features → MCP Servers → 添加 HTTP server。
Trae / VS Code Copilot
类似,填 URL 和 Authorization header。
MCP 暴露了哪些工具
FluxDown MCP server 暴露的工具集覆盖日常下载管理:
| 工具 | 能做什么 |
|---|---|
fluxdown_add_task | 给一个 URL(支持 HTTP/FTP/BT 磁力/eD2K/HLS/DASH),加下载任务 |
fluxdown_list_tasks | 列出所有任务,返回状态/进度/速度/剩余时间 |
fluxdown_pause_task / resume_task | 暂停或恢复某个任务 |
fluxdown_remove_task | 删除某个任务 |
fluxdown_pause_all / resume_all | 一键暂停/恢复全部 |
fluxdown_get_global_stats | 全局统计(当前速度、活跃数、总下载量) |
fluxdown_list_queues | 列出所有命名队列 |
fluxdown_search_tasks | 按文件名/类型搜索历史任务 |
自然语言示例
配置好之后你可以这样对 AI 说:
"帮我把这个 Blender 4.2.1 DMG 下载了:https://example.com/blender-4.2.1-macos-arm64.dmg" → AI 调
fluxdown_add_task,FluxDown 收到任务开始下载。
"我现在正在远程桌面开会,把所有下载暂停一下,开完会再恢复" → AI 调
fluxdown_pause_all。
"看看那个 Ubuntu ISO 下完没有" → AI 调
fluxdown_list_tasks,找到对应任务的状态返回给你。
"下载目录里那个 4K 的 sintel 是多久前下的?" → AI 调
fluxdown_search_tasks按文件名搜,找到后返回创建时间。
安全与边界
- MCP 默认关闭 — 在「设置 → API → 启用 MCP」手动打开(桌面端和 Server 都要)。默认关闭是为了防止任何意外连接。
- 需要 Bearer Token — 和 REST API 一样,MCP 请求也需要 Access Key。AI 配置文件里保存 token——请确保配置文件本身的权限保护好。
- MCP server 不执行任意代码 — 它只暴露预定义的下载管理工具,FluxDown 引擎仍然做自己的限速、队列、持久化。AI 不能让 FluxDown 执行 shell 或读取任意本地文件。
- 和 Remote API 的关系 — 开了 LAN 访问后远程 MCP 也能用(需要 Bearer Token),但不建议裸露到公网。