mcpField
B
Bilibili Subtitle Fetch

Bilibili Subtitle Fetch

Local
github.com/InitsnowBrowser Automation10Updated 16w ago
Repository

About Bilibili Subtitle Fetch

A CLI and MCP server for retrieving subtitles from Bilibili videos. It accepts video IDs and links, offers language and output-format options, and can use ASR when subtitles are unavailable.

Key features

  1. 01Fetch subtitles by ID or link
  2. 02Choose subtitle language
  3. 03Text or timestamped output
  4. 04Optional ASR fallback
  5. 05Copy results to clipboard

Use cases

  1. 01Retrieve subtitles from a Bilibili video
  2. 02Request subtitles in a preferred language
  3. 03Generate subtitles when none are provided

MCP support

The project is identified as an MCP server for fetching Bilibili subtitles. The README does not specify the tools it exposes to MCP clients.

#mcp#bilibili#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "bilibili-subtitle-fetch": {
      "command": "uvx",
      "args": [
        "bilibili-subtitle-fetch"
      ]
    }
  }
}
Run commanduvx bilibili-subtitle-fetch

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypibilibili-subtitle-fetch

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Bilibili 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 语音识别回退

获取 Bilibili 凭据

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.