Bilibili MCP

Bilibili MCP 是一个本地 MCP server，让 AI Agent 读取 Bilibili 内容。你可以读取字幕与评论、按主题搜索视频、按名称或关键词查找并了解 UP 主，也可以遍历自己账号的收藏夹。即使视频没有字幕，通过 setup 安装本地 ASR 模型后也能读到它的文字内容。

English · 客户端配置指南 · 工具参考 · 本地 ASR（可选） · 更新日志 · 最新 Release

_{搜索候选 → 本地 MCP → 字幕定位 · 章节 · 评论 · 收藏夹}

它能做什么

• 读字幕与评论：读取字幕全文，或用关键词搜索原话——每条命中附带上下文、时间点和可直接跳转的 B 站时刻链接；阅读按热度（默认）或时间排序的评论与回复，含时间戳的评论会被优先保留。
• 读单个视频：查看标题、作者、播放量等元数据，以及分 P 结构和章节。
• 找到视频：按主题搜索 B 站，得到按平台综合排序、带标题、UP 主、时长和 BVID 的候选列表。
• 找到 UP 主：搜索 UP 主候选，确认你真正想了解的账号。
• 了解一个 UP 主：查看他的主页概况、视频、合集、系列与动态，快速了解主要创作方向。
• 浏览收藏夹：遍历当前登录账号创建、且 Bilibili 当前可见的全部收藏夹，逐页读取其中的视频。
• 无字幕时本地转录：对确认没有字幕的视频，可显式选择用本机 ASR（faster-whisper）转录，得到与字幕相同结构的转录结果。默认关闭，可在 setup 时选择下载 ASR 模型，详见本地 ASR（可选）。

快速开始

让 Agent 辅助安装（推荐）

把以下提示词完整复制给 Agent：它会完成自己擅长的事（确认客户端、写入 server 配置、检查登录状态），所有涉及 Cookie 的环节都会暂停，交由你本人在本地终端完成。

请帮我安装 Bilibili MCP server：@xzxzzx/bilibili-mcp。

1. 先确认我当前使用的 MCP 客户端，无法确定时请询问我，不要猜测。
   同时运行 node --version 确认 Node.js 为 20 或更高；未安装或版本过低时，先引导我安装或升级。
2. 打开 https://github.com/XZXZZX-Ai/bilibili-mcp/blob/master/docs/client-setup.md，
   找到与当前客户端匹配的配置小节，添加本地 stdio server：
   - server 名称：bilibili-mcp
   - command：npx
   - args：["-y", "@xzxzzx/bilibili-mcp@latest"]
3. 不要要求、接收、收集或显示我的 Cookie 值，也不要自行将其写入聊天或客户端配置中。
4. 暂停并引导我本人在本地终端运行：
   npx -y @xzxzzx/bilibili-mcp@latest setup
   npx -y @xzxzzx/bilibili-mcp@latest check
   npx -y @xzxzzx/bilibili-mcp@latest doctor --json
   doctor --json 只检查本机配置状态，不能代替后面的实时登录验证。
   setup 会询问是否安装可选的本地 ASR 模型，选否即可。自动化环境可用 setup --non-interactive（凭据来自已有的环境变量或全局配置，绝不提示、也绝不从 stdin/argv 读取凭据值）；加 --asr-model <tiny|base|small> 可同时安装指定模型。
5. 让我重启或重连客户端。你无法代替我完成这一步时，请明确让我操作。
6. 重连后调用 MCP 工具 check_bilibili_credentials。
   只有 configured: true 且 logged_in: true 才报告成功。
   - configured: false 或 needs_credentials → 让我运行 npx -y @xzxzzx/bilibili-mcp@latest setup
   - logged_in: false → 让我运行 npx -y @xzxzzx/bilibili-mcp@latest config 强制重配，然后重连再检查
   - MCP server 不可用 → 检查客户端配置并重连
7. 验证成功后：调用一次 search_bilibili_videos（任选主题，如"离散数学"），
   能返回视频列表即说明 Agent 已可读取 Bilibili。

手动安装

前置条件：Node.js 20+

不想用 Agent 辅助时，按下面四步完成同样的流程：

1. 确认环境 — 在终端运行 node --version 和 npx --version，确保 Node.js 为 v20 或更高版本。

2. 添加服务 — 在 MCP 客户端中新增 stdio server：command 设为 npx，args 设为 -y, @xzxzzx/bilibili-mcp@latest。具体操作见客户端配置指南。

3. 本地配置 — 在终端运行 npx -y @xzxzzx/bilibili-mcp@latest setup 配置凭证，再运行 npx -y @xzxzzx/bilibili-mcp@latest check 确认凭证已加载。npx -y @xzxzzx/bilibili-mcp@latest doctor --json 可获取不含秘密的本机配置状态。

   输入不回显，Cookie 只进入本地隐藏提示符，不要粘贴到 Agent 聊天或客户端配置里。凭证字段怎么找：见从浏览器获取凭证字段。setup 还会询问是否安装可选的本地 ASR 模型（默认否），见本地 ASR（可选）。

4. 验证登录 — 重连客户端后，让 Agent 调用 MCP 工具 check_bilibili_credentials 确认 configured: true 且 logged_in: true。doctor --json 只检查本机状态，不能代替这一步的实时登录验证。验证成功后，再让 Agent 调用一次 search_bilibili_videos（任选主题），能返回视频列表即安装完成。

凭证保

... View full README on GitHub