MCP 服务器

Model Context Protocol 服务器，让 AI 智能体替你下载 X（Twitter）视频。

安装

把以下内容加入你的 MCP 客户端配置（Claude Desktop、Claude Code、Cursor 或任何兼容 MCP 的工具）：

{
  "mcpServers": {
    "x-downloader": {
      "command": "npx",
      "args": ["-p", "@roudanio/x-downloader-cli", "x-downloader-mcp"]
    }
  }
}

先运行一次此命令——它会在浏览器中打开设备授权流程，并把 bearer token 保存到 ~/.x-downloader/config.json。MCP 服务器读取的就是这个 token。

npx -p @roudanio/x-downloader-cli x-downloader auth login

仅 stdio——没有独立的服务器进程，也不占用网络端口。服务器使用你保存的 token，通过 HTTPS 调用 xvideodownloader.org 的 REST API。

download_video

提交一个 X/Twitter 帖子 URL 进行下载。自定义文件名和格式需要 SVIP。

check_status

按 id 轮询下载任务，直到状态为 "done"。

get_download_url

获取已完成任务的文件下载 URL。

list_downloads

列出你最近的下载记录。需要认证。

check_usage

查看今日用量与所在套餐每日下载上限的对比。

通过 MCP 服务器发起的下载与网站共用同一套免费/SVIP 每日额度——免费套餐每天 2 次，终身 SVIP 不限次数。

RATE_LIMIT（已达每日上限）、UNSUPPORTED_HOST（仅支持 x.com/twitter.com 链接）、EMPTY_URL / INVALID_URL_FORMAT（输入有误）。工具会在结果中以纯 JSON 文本返回这些错误——请检查 error 或 code 字段。