AI AGENT / MCP TOOL
MCP 服务与 AI Agent 智能下载指南
SaveXTube Desktop 内置了原生的 Model Context Protocol (MCP) 服务引擎(基于 HTTP JSON-RPC 2.0)。配置完成后,AI Agent(如 OpenClaw、Hermes Agent、Claude Desktop、WorkBuddy 等)即可无缝感知并调用本机 SaveXTube 的音视频抓取、批量下载、转写与摘要等强大工具。
1
第一步:在 SaveXTube 设置中开启 MCP 服务
打开 SaveXTube Desktop 客户端,点击左侧导航栏的 「设置」,切换到顶部的 「远程控制」 标签页:
- 开启 MCP 服务:勾选红框标注的 「开启 MCP 服务(自动开启 HTTP API)」;
- 服务运行状态:系统自动启动本机 MCP 守护服务,端点默认显示为
http://127.0.0.1:18530/mcp; - 局域网访问(可选):若 Agent 运行在局域网另一台主机或内网服务器中,可勾选「允许局域网访问」;
- 复制配置:点击 「复制 Agent 配置」 按钮,系统会自动将标准的 MCP 配置 JSON 复制到剪贴板。
2
第二步:将 MCP 配置添加到您的 AI Agent 中
将第一步复制的配置粘贴到您的 AI Agent 客户端配置文件中(如 Claude Desktop 的 claude_desktop_config.json、WorkBuddy、Hermes 或 OpenClaw 的配置文件):
{
"mcpServers": {
"savextube": {
"url": "http://127.0.0.1:18530/mcp",
"headers": {
"Authorization": "Bearer 您的_API_KEY"
}
}
}
}
- 端口与密钥:与 SaveXTube 的 HTTP API 共用端口(默认 18530)和生成的 API Key;
- 连接器授权:在 AI Agent 的工具 / 连接器列表中将
savextube状态设为信任 / 激活。
3
第三步:对话中一句话触发智能下载
在日常与 AI Agent 协作时,直接在对话框中发送任意平台的视频链接或下达自然语言指令:
- 自然语言交互:例如输入 “帮我把这个小红书/B站视频下载下来:https://...” 或 “使用 sxt 下载这段视频”;
- 全自动工具调用:AI Agent 会自动识别意图并调用 SaveXTube 的 MCP 下载工具;
- 极速原画抓取:SaveXTube 在后台以多线程调取最高原画质量下载视频,并自动生成
.nfo完整元数据。
4
第四步:获取下载结果与多模态后续流转
下载完成后,Agent 会立即向您汇报完整下载结果:
- 文件就绪:输出本地存储的完整文件路径、文件大小、来源作者与元数据说明;
- 即点即播:在 Agent 界面中直接预览或播放已下载的高清媒体文件;
- 无缝衔接本地 AI:文件已同步归档至 SaveXTube「文件」库,Agent 也可继续链式调用语音转写、AI 总结与思维导图生成。