impeccable
The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.
Bilibili MCP tool for video metadata, transcripts, subtitles, and comment summarization
Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem
The design vocabulary for your coding agent. Steer with polish and bolder, review with critique and audit, catch AI slop before it ships.
Editorial diagram design for Claude Code, Codex, GitHub Copilot, Cursor, Factory Droid, Qoder, and Pi. 45 diagram types. Self-contained HTML + SVG. No shadows. No Mermaid slop.
Create beautiful slides on the web using a coding agent's frontend skills
Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert
| Beliebtheit | 27/80 | GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20 |
|---|---|---|
| Aktualität | 12/12 | Volle Punkte für Release oder Codeänderung in 30 Tagen |
| Antwortet noch | 0/8 | Der Cloud-Endpoint antwortete bei der letzten Prüfung |
| Nutzungswert | 39/100 |
Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
Mit einem Satz von deiner KI installieren lassen
Installiere bitte Bilibili MCP Server. Folge https://mcp.popnx.com/i/xzxzzx-ai-bilibili-mcp.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen
3/3 Prüfungen bestanden · Läuft auf deinem Computer · ✓ Befehle geprüft am 13. Nov. 2026
Zuerst: Welche KI nutzt du?
Wähle deine App, dann erscheinen die Schritte unten.
Klappt mit Claude, aber erst etwas vorbereiten
Installiere zuerst Node.js auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
Kopiere diese Nachricht in einen Claude-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Bilibili MCP Server für Claude auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "bilibili": { "command": "npx", "args": [ "-y", "@xzxzzx/bilibili-mcp" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Bilibili MCP Server wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
SettingsDeveloperEdit Config
{
"mcpServers": {
"bilibili": {
"command": "npx",
"args": [
"-y",
"@xzxzzx/bilibili-mcp"
]
}
}
}Nutze Bilibili MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude sagt, dass es Bilibili MCP Server nutzt, oder ein Werkzeug von Bilibili MCP Server in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
ChatGPT kann Bilibili MCP Server noch nicht verbinden
Bilibili MCP Server läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen
A · Eine App nutzen, die Bilibili MCP Server verbinden kann
B · Andere in Design, Bilder & Audio, die mit ChatGPT funktionieren
Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden
Klappt mit Claude Code, aber erst etwas vorbereiten
Installiere zuerst Node.js auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen Claude Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Bilibili MCP Server für Claude Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): claude mcp add --scope user bilibili -- npx -y @xzxzzx/bilibili-mcp 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Bilibili MCP Server wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
claude mcp add --scope user bilibili -- npx -y @xzxzzx/bilibili-mcpBilibili MCP Server sollte in der Liste als verbunden erscheinen
Nutze Bilibili MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude Code sagt, dass es Bilibili MCP Server nutzt, oder ein Werkzeug von Bilibili MCP Server in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Cursor, aber erst etwas vorbereiten
Installiere zuerst Node.js auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen Cursor-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Bilibili MCP Server für Cursor auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "mcpServers": { "bilibili": { "command": "npx", "args": [ "-y", "@xzxzzx/bilibili-mcp" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Bilibili MCP Server wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
Nutze Bilibili MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Cursor sagt, dass es Bilibili MCP Server nutzt, oder ein Werkzeug von Bilibili MCP Server in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit VS Code, aber erst etwas vorbereiten
Installiere zuerst Node.js auf deinem Computer (nur einmal)
Kopiere diese Nachricht in einen VS Code-Chat. Die KI prüft deinen Rechner, sagt dir, welche Datei sie ändert, und wartet jedes Mal auf dein OK.
Installiere bitte den MCP server Bilibili MCP Server für VS Code auf diesem Rechner, in dieser Reihenfolge: 1) Prüfe Node.js mit node -v. Fehlt es, sag mir, dass ich es von https://nodejs.org/en/download installiere; installiere es nicht selbst. 2) Verwende nur diese Konfiguration (von PopNx MCP geprüft): { "servers": { "bilibili": { "type": "stdio", "command": "npx", "args": [ "-y", "@xzxzzx/bilibili-mcp" ] } } } 3) Nenne mir den vollständigen Pfad der Datei, die du änderst, oder den Befehl, den du ausführst, und warte auf mein OK. 4) Kein Schlüssel nötig. 5) Führe das Vereinbarte aus und prüfe, dass die Tools von Bilibili MCP Server wirklich erscheinen.Diese Nachricht enthält keinen Schlüssel. Wird einer gebraucht, bittet dich die KI, ihn selbst in die Datei oder das Feld der App einzufügen.
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
node -vMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Öffne die offizielle Download-Seite, wähle die LTS-Version und den Klick-Installer: .pkg auf dem Mac · .msi unter Windows. Doppelklicken und bis zum Ende durchklicken. Kein curl-Befehl nötig
Download-Seite von Node.js öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: node -v
Einmal installieren, gilt für alles, was Node.js braucht
VS Code fragt nach einer Bestätigung; klicke Install
Nutze Bilibili MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn VS Code sagt, dass es Bilibili MCP Server nutzt, oder ein Werkzeug von Bilibili MCP Server in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach
JSON-Einstellungen stehen unten unter „Für Entwickler“
Claude Code
claude mcp add --scope user bilibili -- npx -y @xzxzzx/bilibili-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"bilibili": {
"command": "npx",
"args": [
"-y",
"@xzxzzx/bilibili-mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"bilibili": {
"command": "npx",
"args": [
"-y",
"@xzxzzx/bilibili-mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"bilibili": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@xzxzzx/bilibili-mcp"
]
}
}
}Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.
Laufen auf deinem Computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026
Der Registry-Name wurde mit dem GitHub-Konto XZXZZX-Ai bestätigt, dem das Repo gehört
Code zuletzt geändert: gestern
Nutzt Apache-2.0
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Keine Einträge auf OSV.dev für @xzxzzx/bilibili-mcp@1.14.5
Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 15. Nov. 2026
Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.
[](https://mcp.popnx.com/en/servers/xzxzzx-ai-bilibili-mcp)Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Noch keine Bewertungen
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Das GitHub-Repo wurde zuletzt gestern geändert, und die neueste Version (1.14.5) kam vor 25 Tagen in die Registry.
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.
In derselben Kategorie: HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server
Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
Official HyperFrames by HeyGen: the best AI video editor in chat. Captions, motion graphics, MP4.
Create, inspect, validate, and save editable 3D building scenes with Pascal's MCP server.
Create draw.io diagrams in chat from Mermaid or XML, shown live and interactive. 10,000+ shapes.
The Figma MCP server brings Figma design context directly into your AI workflow.
Hosted MCP for Remotion videos: search Remocn components, read docs, plan a video, preview it.
| Dieser Bilibili MCP Server | HyperFrames by HeyGen | Pascal 3D Editor | draw.io | Figma MCP Server | Remocn: Remotion MCP server | |
|---|---|---|---|---|---|---|
| Läuft wo | Wird auf deinem Rechner installiert | Läuft in der Cloud, keine Installation | In der Cloud oder auf deinem Rechner | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation |
| Braucht Schlüssel | Nein | Nein | Nein | Nein | Nein | Nein |
| Mit + in Claude hinzufügen | Nein | Ja | Nein | Nein | Ja | Nein |
| Basisprüfungen | 3/3 | 4/4 | 5/5 | 4/4 | 4/4 | 4/4 |
| Lizenz | Apache-2.0 | Apache-2.0 | MIT | Apache-2.0 | – | MIT |
| Preis | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register |
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
Bilibili MCP 是一个本地 MCP server,让 AI Agent 读取 Bilibili 内容。你可以读取字幕与评论、按主题搜索视频、按名称或关键词查找并了解 UP 主,也可以遍历自己账号的收藏夹。即使视频没有字幕,通过 setup 安装本地 ASR 模型后也能读到它的文字内容。
English · 客户端配置指南 · 工具参考 · 本地 ASR(可选) · 更新日志 · 最新 Release
搜索候选 → 本地 MCP → 字幕定位 · 章节 · 评论 · 收藏夹
setup 时选择下载 ASR 模型,详见本地 ASR(可选)。把以下提示词完整复制给 Agent:它会完成自己擅长的事(确认客户端、写入 server 配置、检查登录状态),所有涉及 Cookie 的环节都会暂停,交由你本人在本地终端完成。
请帮我安装 Bilibili MCP server:@xzxzzx/bilibili-mcp。
前置条件:Node.js 20+
不想用 Agent 辅助时,按下面四步完成同样的流程:
node --version 和 npx --version,确保 Node.js 为 v20 或更高版本。command 设为 npx,args 设为 -y, @xzxzzx/bilibili-mcp@latest。具体操作见客户端配置指南。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(可选)。
check_bilibili_credentials 确认 configured: true 且 logged_in: true。doctor --json 只检查本机状态,不能代替这一步的实时登录验证。验证成功后,再让 Agent 调用一次 search_bilibili_videos(任选主题),能返回视频列表即安装完成。凭证保存在 ~/.bilibili-mcp/config.json(Windows:%USERPROFILE%\.bilibili-mcp\config.json),不保证操作系统级加密。登录失败时的排查路径见客户端配置指南。
运行 setup 后,按回车选择扫码登录,用手机 B站 App 扫描终端里的二维码,再在手机上确认即可。无需从浏览器复制 Cookie,更简单方便。
无法扫码? 二维码显示异常(块字符破碎、空心方框)时,Windows 传统控制台的处理见客户端配置指南。也可以在登录方式菜单选择“手动 Cookie”,按照手动 Cookie 配置教程获取凭证并在本地终端输入。
读取 BV1Eb411u7Fw 的字幕,带时间戳返回;
再获取这个视频最热门的评论和回复。
Agent 返回带时间戳的字幕文本,以及热门评论与回复;含时间戳的评论会被优先保留。
搜索 B 站上关于"离散数学"的视频,按 B 站综合排序列出 5 个候选,
包含标题、UP 主、时长和 BVID;先不要读取字幕。
Agent 返回 5 个候选,各带标题、UP 主、时长和 BVID。选中候选后,把 BVID 直接交给转录、元数据、章节或评论工具。
搜索“毕导THU”,列出 UP 主候选,等我确认正确账号后,
先查看他的主页概况,再分别查看最新视频、合集、系列和动态。 根据已经返回的内容概括主要创作方向,并推荐几条适合继续了解的视频; 先不要翻完所有页面,也不要读取字幕、评论或识别动态图片。
Agent 会先让你确认正确的 UP 主,再分批读取不同类型的内容。需要查看更多时,它会继续翻页;选中的视频还可以交给字幕、元数据、章节或评论工具深入查看。
读取 BV1Eb411u7Fw 的 P4 字幕,搜索"函数",
返回命中上下文、时间点和可以直接打开的 B 站链接。
每条命中附带原文上下文、时间点和可直达的 B 站时刻链接。
[!NOTE]
已验证的验收链路:搜索视频 → 选择
BV1Eb411u7Fw的 P4 → 在字幕中搜索函数→ 返回上下文与可直达的?p=4&t=1.12证据链接。Bilibili 可能移除或变更该示例视频。
遍历我当前登录账号创建且 Bilibili 当前可见的全部收藏夹。持续跟随
next_cursor 直到结束;按收藏夹列出成功读取的视频标题和 B 站视频 ID(BVID), 并报告 skipped_count。
每次 MCP 调用最多读取一个 20 条的上游页面;Agent 使用返回的 next_cursor 继续调用,直到该字段不再出现。最终按收藏夹输出成功读取的标题与 BVID 列表,以及被跳过的条目计数。
这个视频没有字幕。请调用 get_video_transcript 并把 fallback_to_asr 设为 true,
用本地 ASR 转录当前这一 P,返回带时间戳的文本。
前提是已经通过 setup 安装了模型且 doctor --json 报告 asr.status: ready,否则会返回 ASR_NOT_READY 并附带安装指引。原生字幕始终优先:只有确认没有可用字幕时才会启动一次本地转录,结果返回 data_source: "asr",并复用与字幕相同的时间戳、区间过滤、关键词搜索和时刻链接。详见本地 ASR。
Bilibili 会把部分视频的 AI 识别字幕标为 ai-zh、ai-en、ai-ja 等 ai-* 语言。为避免与人工字幕混淆,选中任意 ai-* 字幕时,get_video_transcript 与 get_video_info 的结果返回 data_source: "ai_subtitle"(不是 "subtitle";本地 ASR 仍是 "asr")。
ai_subtitle 是 Bilibili 的 AI 转录,可能不准确,不能当作人工校验过的引用。exclude_ai_subtitles: true(两个工具都有,默认 false):过滤全部 AI 字幕(ai-zh、ai-en 等),优先返回剩余的人工字幕;仅剩 AI 字幕时视为无字幕,get_video_transcript 可配合 fallback_to_asr / fallback_to_description,get_video_info 返回简介。force_asr: true(仅 get_video_transcript,默认 false):绕过字幕元数据与内容选择,直接用本地 ASR 转录当前这一 P;无需同时开启 fallback_to_asr,且优先于 exclude_ai_subtitles。ai-* 都会无条件双读并做确定性完整性评估,通过后才返回正文:跨读取稳定性(两次读取的正文不一致即不可用,适用于所有 ai-*)、语言(仅针对 ai-zh:≥80 Unicode 字母且 Han 占比 <10% 视为不匹配;其他 ai-* 语言不因非中文正文被拒绝);不通过时 fallback_to_asr: true 调用本地 ASR,否则遵循 fallback_to_description;video-info 返回简介且不缓存。同语言但语义不符(稳定却离题的正文)是已接受的限制,可用 force_asr 或 exclude_ai_subtitles 控制;人工字幕保持单读,第二次读取的传输、超时、认证或解析失败照常作为错误返回。有些视频没有任何字幕。安装本地 ASR 模型后,get_video_transcript 可以在你显式开启 fallback_to_asr 时,对已解析的这一 P 做一次本地转录。
安装:凭证配置完成后,setup 会询问是否安装本地 ASR 模型(默认否 [y/N],需要 Python 3.9+)。可选模型:
| 模型 | 大小 | 说明 |
|---|---|---|
| tiny | ~78 MB | 速度优先:适合快速提取和长视频初筛;准确率相对较低 |
| base | ~148 MB | 均衡:兼顾速度、质量和资源占用 |
| small | ~486 MB | 质量优先:耗时和内存占用更高;推荐,Enter 默认选中 |
Runtime 固定为 faster-whisper==1.2.1 与 ctranslate2==4.8.0,模型存放在用户目录 ~/.bilibili-mcp/asr/,不需要系统 FFmpeg;同一目录仅保留一个活跃模型。选择模型后还需选择设备偏好:auto(默认)先用程序生成的固定短 WAV 完整验证 cuda/float16,失败时说明脱敏原因并验证、保存 cpu/int8;cpu 跳过 GPU;cuda 验证失败则报错且不回退。doctor --json 会报告实际生效的 device、compute_type、readiness 与脱敏失败类别。
项目不会安装或修改 NVIDIA 驱动、CUDA、cuBLAS、cuDNN、系统 PATH、LD_LIBRARY_PATH 或全局 Python。GPU 验证失败后,你可以继续使用已经验证的 CPU,也可以自行修复 GPU 环境后重新运行 setup;每次重新运行都会再次验证设备。
从旧版本升级:已有 v1 ASR 安装无需重新下载模型。升级后的第一次明确 ASR 请求会自动验证 GPU/CPU,并在验证成功后继续完成本次转录;成功后会保存新状态,后续请求不再重复探测。若迁移失败或被取消,原状态保持待迁移,可在修复环境后重新运行 setup 重试。
边界:本地转录始终被约束在安全范围内——显式选择、资源受限、Cookie 隔离:
ai-* 都会先无条件双读评估,不通过时与无字幕一样构成确认缺失(默认返回简介或 SUBTITLE_UNAVAILABLE);只有在这种确认缺失状态、且你显式传了 fallback_to_asr: true 时才启动转录。force_asr: true 是显式授权直接转录当前这一 P,与是否存在字幕无关,无需同时开启 fallback_to_asr。setup 安装。ASR_NOT_READY、ASR_FAKE_IP_DNS、ASR_BUSY、ASR_TRANSCRIPTION_TIMEOUT 等错误码的完整语义和安全处理方式见工具参考;遇到 Fake-IP 诊断时,不需要关闭整个代理。
| 目标 | 工具 |
|---|---|
| 只有主题,还没有视频链接 | search_bilibili_videos |
| 知道名称或关键词,想找 UP 主候选(稳定 mid) | search_bilibili_creators |
| 从选定 UP 主(mid)读取概览、视频目录、合集、系列或动态 | get_bilibili_creator_content |
| 从我的收藏夹开始读取 | list_bilibili_favorite_videos |
| 快速获取字幕优先的视频上下文 | get_video_info |
| 完整转录、关键词定位,或无字幕时本地 ASR | get_video_transcript |
| 查看标题、作者、播放量等结构化信息 | get_video_metadata |
| 查看观众反馈和评论回复 | get_video_comments |
| 查看视频章节/进度条分段 | get_video_chapters |
| 引导用户配置 Cookie | get_credential_setup_instructions |
| 检查 Cookie 是否已配置且已登录 | check_bilibili_credentials |
| 检查 MCP 包是否需要更新 | check_mcp_update |
完整参数、JSON 示例和错误语义见工具参考。
next_cursor。遍历是实时 best-effort,不是快照。skipped_count,不会为该页拉取替代条目。ai-* 默认都会双读,完整性不通过时即使未开启 ASR 也会降级为简介或 SUBTITLE_UNAVAILABLE;本地转录只会在确认无字幕并显式开启 fallback_to_asr,或设置 force_asr 时运行一次,且需要本机已有 ready 模型。ai-zh 等任意 ai-* 语言)时 data_source 为 ai_subtitle;它是 Bilibili 的 AI 转录,可能不准确,不能当作人工校验过的引用。需要纯人工字幕时使用 exclude_ai_subtitles: true。get_video_transcript 默认在无字幕时返回 SUBTITLE_UNAVAILABLE;描述降级(fallback_to_description)与关键词搜索、时间戳输出和时段过滤互斥。setup 在本地终端交互式输入,保存在本机全局配置中,不会写入项目或 MCP 客户端配置文件。SESSDATA、bili_jct、DedeUserID 或完整 Cookie。git clone https://github.com/XZXZZX-Ai/bilibili-mcp.git
cd bilibili-mcp npm install npm run build npm test
| 命令 | 用途 |
|---|---|
npm run build | 清理并编译 TypeScript 到 dist/ |
npm test | 运行 Vitest 测试 |
npm run watch | 监听 TypeScript 变更 |
npm start | 启动已构建的 stdio MCP server |
npm pack --dry-run | 检查 npm 发布包内容 |
MCP stdio 协议数据使用 stdout;调试日志必须写到 stderr。测试和日志中不要使用真实 Cookie。
遇到问题或有功能建议,请提交 GitHub Issue;一般讨论可前往 GitHub Discussions。
本项目基于 Apache License 2.0 开源。