Skip to main content
Glama
RookieApe-tao

grabit-mcp

by RookieApe-tao
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

grabit-mcp

全平台高清视频下载器 —— 一个包三种用法：命令行 CLI、MCP Server（给 AI Agent 用）、手机网页。 支持 YouTube / X(Twitter) / Telegram / B站 / 抖音 / TikTok / 小红书 / Instagram 等，默认最高画质原始码流（ffmpeg 合并、无转码），抖音可接无水印 API。

仅供个人备份与已授权内容。请尊重各平台版权与服务条款，勿用于二次分发或商业用途。

特性

  • 🎯 最高画质默认：bestvideo+bestaudio 自动合并 mp4，可选 4K/1080/720/480/仅音频

  • 🪄 环境自愈：首次运行自动检测并下载 yt-dlp / ffmpeg 到 ~/.grabit/bin（免管理员、不污染 PATH）

  • ✨ 本地画质优化：grabit enhance 去压缩伪影+锐化重编码（light/strong 两档），改善平台重压缩的模糊色块

  • 🤖 MCP Server：6 个结构化工具，DSH / Claude Desktop 等任意 MCP 客户端可用

  • 📱 手机网页：grabit serve 一键启动，手机浏览器直接下载 + 取回电脑上已下载的文件

  • 🧩 平台路由：URL 自动识别平台；抖音预留无水印 API 通道

  • 📦 换机零成本：GitHub + npm 托管代码，新电脑两条命令完全恢复

Related MCP server: video-link-analyzer

安装

Windows（PowerShell 一条命令）：

irm https://raw.githubusercontent.com/RookieApe-tao/grabit-mcp/main/setup.ps1 | iex

macOS / Linux：

curl -fsSL https://raw.githubusercontent.com/RookieApe-tao/grabit-mcp/main/setup.sh | bash

脚本做的事：克隆到 ~/.grabit/app → npm i -g 本地目录（dist 已预编译，无需构建）→ grabit doctor --fix 自动补齐 yt-dlp/ffmpeg。 更新版本 = 重跑同一条命令。

npm 注册表版（npm i -g grabit-mcp）等账号就绪后提供；当前 GitHub 直装即全功能。

从源码构建：

git clone git@github.com:RookieApe-tao/grabit-mcp.git
cd grabit-mcp && npm install && npm run build
node dist/cli.js --help

CLI 用法

grabit "https://www.bilibili.com/video/BV..."            # 最高画质
grabit "https://x.com/user/status/123" -q 1080           # 指定画质
grabit "https://youtu.be/xxx" -q audio                   # 仅音频 mp3
grabit info "https://..."                                # 查标题/可用画质
grabit batch urls.txt                                    # 批量（每行一个链接）
grabit enhance <文件或目录> --strong                      # 本地画质优化（去伪影+锐化）
grabit serve                                             # 启动手机网页（默认 :8787）
grabit doctor [--fix]                                    # 环境自检/自动修复
grabit config outputDir "D:/Videos"                      # 改输出目录

会员/登录内容（如 B 站大会员画质）：

grabit "https://..." --cookies-from-browser edge

MCP 接入

通用配置（Claude Desktop / 任意 MCP 客户端）：

{
  "mcpServers": {
    "grabit": { "command": "grabit-mcp" }
  }
}

工具列表：

工具

说明

media_info

查询标题/时长/UP主/可用画质/平台

media_download

下载（quality/audio、输出目录、cookies 等参数）

media_batch

批量下载并汇总结果

media_cookies

设置/清除浏览器登录态

media_doctor

环境自检

本地画质优化（enhance）

平台（尤其 X）会重压缩视频导致模糊/色块。grabit enhance 用 ffmpeg 做本地修复：

grabit enhance video.mp4                # 轻优化：去噪(hqdn3d) + 锐化(cas)，CRF16 重编码
grabit enhance video.mp4 --strong       # 强优化：加强去噪 + 双重锐化
grabit enhance "D:/Downloads/grabit"    # 整个目录批量（自动跳过已优化的）

输出为 原名_优化.mp4 / 原名_强优化.mp4，源文件不动。 预期：观感更干净锐利（尤其文字与静止画面）；不会凭空恢复被平台压缩掉的真实细节。

AI 超分（Real-ESRGAN，逐帧处理再合成）：需要支持 Vulkan 的 GPU（近 8 年的独显/核显均可）； 老显卡（如 Fermi 系 GTX 5xx）无 Vulkan 无法运行，CPU 纯跑速度不可接受。

手机端（不需要服务器）

grabit serve --host 0.0.0.0   # 默认已监听 0.0.0.0

  • 在家：手机连同一 Wi-Fi，访问启动时打印的 局域网访问 地址，可"添加到主屏幕"当 App 用

  • 出门：电脑和手机都装 Tailscale（免费），手机随时访问电脑的 Tailscale IP

  • 页面里可以直接取回电脑上已下载的文件（走 /api/file 流式传输）

⚠ 仅供局域网/个人组网使用，不要把端口暴露到公网（服务无鉴权）。

抖音无水印（可选增强）

抖音默认走 yt-dlp（可能带水印/需 cookies）。要稳定无水印，自托管一次解析 API：

docker run -d -p 8000:8000 --name douyin-api evil0ctal/douyin-tiktok-download-api
grabit config douyinApi http://127.0.0.1:8000

之后 grabit "https://v.douyin.com/xxx/" 直接得到无水印原片。

配置项（~/.grabit/config.json，grabit config show 查看）

键

说明

outputDir

下载输出目录（默认 ~/Downloads/grabit）

binDir

yt-dlp/ffmpeg 存放目录（默认 ~/.grabit/bin）

ytDlpPath / ffmpegPath

显式指定已有二进制路径

cookiesFromBrowser

edge / chrome / firefox ...

cookiesFile

Netscape cookie 文件

douyinApi

抖音无水印解析 API 地址

DSH 集成（MCP + Skill，换机三步）

第 1 步：安装工具本体

运行上面的一键安装命令（setup.ps1 / setup.sh）。

第 2 步：挂 MCP —— 编辑 ~/.dsh/profiles/web/cordis.patch.yml，追加：

# grabit MCP — 全平台视频下载 (YouTube/X/Telegram/抖音/B站/TikTok/小红书)
# Tools register as mcp__grabit__* (media_info / media_download / media_batch /
# media_cookies / media_doctor).
- insert:
    - id: mcp-grabit
      name: '@deepseek-ai/dsh-mcp-client'
      config:
        serverName: grabit
        transport: stdio
        command: node
        args:
          - C:/Users/<你>/AppData/Roaming/npm/node_modules/grabit-mcp/dist/mcp-server.js

  • args 里的路径换成自己的 npm 全局目录（npm root -g 查看；macOS/Linux 一般是 /usr/local/lib/node_modules/... 或 ~/.npm-global/lib/node_modules/...）

  • DSH 要求 command 为绝对路径，所以用 node + js 绝对路径的方式

  • 验证：dsh --profile web --dump-config | grep mcp-grabit；重启 dsh web 后工具生效

第 3 步：装 Skill

# Windows（macOS/Linux 路径为 ~/.dsh/skills/grabit/SKILL.md）
New-Item -ItemType Directory -Force "$env:USERPROFILE\.dsh\skills\grabit" | Out-Null
Copy-Item "<仓库目录>\skill\GRABIT.md" "$env:USERPROFILE\.dsh\skills\grabit\SKILL.md"

保存后即时生效（无需重启）。之后对 Agent 说"下载这个视频链接"就会直接触发。

换电脑恢复 = 上面的三步

① 一键安装命令（工具本体 + 环境自愈） → ② cordis.patch 挂 MCP（重启 dsh web 生效） → ③ 拷 Skill（即时生效）。

环境、配置、下载全在本机自动完成，无需迁移。

开发

npm install
npm run build        # tsc 编译到 dist/
npm run smoke:mcp    # MCP stdio 握手冒烟测试

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers