关于 Bilibili Subtitle Fetch
这是一款用于获取 Bilibili 视频字幕的命令行工具和 MCP 服务,可通过视频编号或链接检索字幕,选择语言与输出格式,并在缺少字幕时使用 ASR。
主要功能
- 01通过编号或链接获取字幕
- 02选择字幕语言
- 03输出文本或带时间戳内容
- 04可选 ASR 回退
- 05将结果复制到剪贴板
适用场景
- 01获取 Bilibili 视频字幕
- 02按指定语言检索字幕
- 03在视频没有字幕时生成字幕
MCP 相关
该项目被介绍为用于获取 Bilibili 字幕的 MCP 服务。README 未说明其向 MCP 客户端提供的具体工具。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
来自项目 READMEBilibili Subtitle Fetch
一个用于获取 Bilibili 视频字幕的 MCP Server,支持语言和输出格式选项。
uv tool install --python 3.13 bilibili-subtitle-fetch
支持以下输入:
BV号,例如BV1fz4y1j7Mf- 标准视频链接,例如
https://www.bilibili.com/video/BV1fz4y1j7Mf?p=2 - 短链,例如
https://b23.tv/FAm7Xn4
配置
凭据配置文件
首次使用时执行 bilibili-subtitle-fetch init,然后粘贴你的 Bilibili Cookie。
默认配置文件路径:
- Windows:
%APPDATA%\bilibili-subtitle-fetch\config.toml - Linux/macOS:
~/.config/bilibili-subtitle-fetch/config.toml
也可以通过 --config /path/to/config.toml 指定自定义路径。
配置文件会在 [credential] 下保存这些字段:
sessdata- 访问需要登录态的字幕接口时必需bili_jct- 自动刷新时必需ac_time_value- 自动刷新时必需buvid3、buvid4、dedeuserid- 可选,但建议一并保存
当 sessdata、bili_jct 和 ac_time_value 都存在时,服务会在发起需要登录态的请求前自动检查是否需要刷新 Cookie,并将新值回写到 config.toml,不需要手动执行刷新命令。
ASR 配置 (可选)
配置文件同样支持 [asr] 段落配置默认的音频转写行为:
enable_asr- 是否开启 ASR 回退 (true/false)。开启后,如果视频未提供自带字幕,程序会自动下载音频并生成字幕。model_size- Whisper 模型大小,默认为base。也可以选用tiny、small等。
运行参数
--preferred-lang- 覆盖默认字幕语言--output-format- 覆盖默认输出格式--config- 使用自定义配置文件路径
CLI 用法
先执行 bilibili-subtitle-fetch init 配置 Cookie,然后可以直接在终端获取字幕:
bilibili-subtitle-fetch fetch BV1fz4y1j7Mf
bilibili-subtitle-fetch fetch "https://www.bilibili.com/video/BV1fz4y1j7Mf?p=2"
命令会把字幕输出到标准输出,并在成功后自动复制到剪贴板。
可选参数:
--preferred-lang- 指定优先字幕语言--output-format text|timestamped- 指定输出格式--no-clipboard- 只输出,不复制到剪贴板--asr- 强制启用 ASR 语音识别回退--no-asr- 强制关闭 ASR 语音识别回退
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。