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
이런 작업을 AI에게 가르치는 Skill, 이것과 함께 쓸 수 있습니다
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
목록은 사용 점수(100점 만점)로 정렬되며 구성은 다음과 같습니다
| 인기 | 27/80 | GitHub 별 또는 주간 다운로드: 큰 쪽 60, 작은 쪽 20 |
|---|---|---|
| 최신성 | 12/12 | 30일 안에 릴리스나 코드 변경이 있으면 만점 |
| 응답 중 | 0/8 | 마지막 점검 때 클라우드 엔드포인트가 응답 |
| 사용 점수 | 39/100 |
품질: 기본 점검 3/3개 통과(표시만, 정렬에는 안 씀) · 상승세: 데이터 없음 (급상승 탭에서만 사용)
쓰고 있는 AI 앱을 고른 다음 설정을 복사하세요.
한 문장으로 AI에게 설치 맡기기
Bilibili MCP Server 설치해 줘. https://mcp.popnx.com/i/xzxzzx-ai-bilibili-mcp.md 를 따라 하고, 명령을 먼저 보여 주고 내가 승인하면 실행해.내 컴퓨터에서 작업하는 AI(Claude Code, Cursor 등)에 붙여 넣으세요. 단계를 읽고 명령을 보여 준 뒤 승인을 기다립니다. 키도 가입도 필요 없습니다. · AI가 읽을 전체 내용 보기
검사 3/3 통과 · 내 컴퓨터에서 실행돼요 · ✓ 명령 확인 2026년 11월 20일
먼저: 어떤 AI를 쓰시나요?
쓰는 앱을 고르면 아래에 단계가 나옵니다.
Claude에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만) · 컴퓨터용 Claude 앱(Windows 또는 Mac)에서만 되고 웹이나 모바일은 안 돼요
이 메시지를 Claude 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Claude에 MCP server Bilibili MCP Server을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "mcpServers": { "bilibili": { "command": "npx", "args": [ "-y", "@xzxzzx/bilibili-mcp" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 Bilibili MCP Server의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -vMac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다: node -v
한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
SettingsDeveloperEdit Config
{
"mcpServers": {
"bilibili": {
"command": "npx",
"args": [
"-y",
"@xzxzzx/bilibili-mcp"
]
}
}
}Bilibili MCP Server을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude가 Bilibili MCP Server을 쓰고 있다고 하거나 답에 Bilibili MCP Server 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
ChatGPT는 아직 Bilibili MCP Server에 연결할 수 없어요
Bilibili MCP Server는 내 컴퓨터에 설치해서 쓰지만 ChatGPT는 웹에서 도는 서버만 연결할 수 있어요
A · Bilibili MCP Server에 연결되는 앱 쓰기
B · 디자인, 이미지 및 오디오에서 ChatGPT에 연결되는 다른 서버
같은 분류에서 많이 쓰는 것 중 키 없이 주소만으로 연결되는 것을 골랐어요
Claude Code에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
이 메시지를 Claude Code 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Claude Code에 MCP server Bilibili MCP Server을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): claude mcp add --scope user bilibili -- npx -y @xzxzzx/bilibili-mcp 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 Bilibili MCP Server의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -vMac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다: node -v
한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
Mac: Command+스페이스를 누르고 Terminal 입력 · Windows: PowerShell 열기
claude mcp add --scope user bilibili -- npx -y @xzxzzx/bilibili-mcpBilibili MCP Server이 목록에 있고 연결됨으로 보이면 돼요
Bilibili MCP Server을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Claude Code가 Bilibili MCP Server을 쓰고 있다고 하거나 답에 Bilibili MCP Server 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Anthropic 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
Cursor에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
이 메시지를 Cursor 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 Cursor에 MCP server Bilibili MCP Server을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "mcpServers": { "bilibili": { "command": "npx", "args": [ "-y", "@xzxzzx/bilibili-mcp" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 Bilibili MCP Server의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -vMac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다: node -v
한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
Bilibili MCP Server을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ Cursor가 Bilibili MCP Server을 쓰고 있다고 하거나 답에 Bilibili MCP Server 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 Cursor 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
VS Code에 연결할 수 있지만 먼저 준비가 필요해요
먼저 컴퓨터에 Node.js를 설치하세요 (한 번만)
이 메시지를 VS Code 채팅에 붙여 넣으세요. AI가 컴퓨터를 확인하고 어떤 파일을 바꿀지 알려 준 뒤 매번 동의를 기다립니다.
이 컴퓨터의 VS Code에 MCP server Bilibili MCP Server을 설치해 주세요. 순서대로: 1) node -v로 Node.js가 있는지 확인. 없으면 https://nodejs.org/en/download에서 설치하라고 알려 주고 직접 설치하지 마세요. 2) 이 설정만 사용하세요(PopNx MCP 확인 완료): { "servers": { "bilibili": { "type": "stdio", "command": "npx", "args": [ "-y", "@xzxzzx/bilibili-mcp" ] } } } 3) 바꿀 파일의 전체 경로나 실행할 명령을 알려 주고 제 동의를 기다리세요. 4) 키는 필요 없습니다. 5) 합의한 대로 실행한 뒤 Bilibili MCP Server의 도구가 실제로 보이는지 확인하세요.이 메시지에는 키가 없습니다. 키가 필요하면 AI가 파일이나 앱 입력란에 직접 붙여 넣으라고 안내합니다.
이미 설치했나요? 먼저 확인 · 터미널을 열고 이 명령을 입력한 뒤 Enter
node -vMac: ⌘ + Space를 누르고 Terminal 입력 후 Enter
Windows: 시작 메뉴를 열고 Windows PowerShell 입력 후 "열기"
아직 설치하지 않았다면: 공식 다운로드 페이지에서 LTS 버전과 클릭형 설치 파일을 고르세요: Mac은 .pkg · Windows는 .msi. 더블클릭 후 끝까지 진행하면 됩니다. curl 명령은 필요 없습니다
설치가 끝나면 터미널을 닫았다가 다시 열고 같은 명령을 실행하세요. 버전 번호가 나와야 합니다: node -v
한 번 설치하면 Node.js가 필요한 모든 도구에서 쓸 수 있습니다
Bilibili MCP Server을 써서 나에게 무엇을 해 줄 수 있는지 알려 주고, 하나 해 봐✓ VS Code가 Bilibili MCP Server을 쓰고 있다고 하거나 답에 Bilibili MCP Server 도구 이름이 나오면 연결된 거예요
메뉴 이름은 2026년 11월 11일에 VS Code 도움말에서 확인 · 앱 버전에 따라 화면이 조금 다를 수 있어요
Windsurf, Zed, Gemini CLI 같은 다른 MCP 앱은 추가 방법이 저마다 달라요. 앱 목록에서 확인하세요
JSON 설정은 아래 “개발자용”에 있어요
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"
]
}
}
}이 설정은 제작자의 레지스트리 정보로 만들었어요. README와 다르면 README를 따르세요.
이 서버의 연결 방식과 각 앱의 공식 문서를 바탕으로 했어요. 2026년 11월 10일 확인.
내 컴퓨터에서 실행하는 앱
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
내 컴퓨터에서 실행돼요. 설치하면 AI 앱에 도구 목록이 나타나요.
누구나 볼 수 있는 정보를 점검했고, 코드는 읽지 않았어요. 해당하지 않는 항목은 개수에서 뺐어요. · 2026년 11월 20일 점검
레지스트리 이름이 GitHub 계정 XZXZZX-Ai 기준으로 확인되었고, 이 계정이 저장소를 소유하고 있어요
코드 마지막 변경: 어제
Apache-2.0 사용
내 컴퓨터에서 실행되는 서버라 인터넷 엔드포인트가 없어요
내 컴퓨터에서 실행되며, 대신 로컬 설정을 사용해요
내 컴퓨터에서 실행돼요. 도구 목록은 인터넷 엔드포인트가 있는 서버에서만 읽을 수 있어요
OSV.dev에 @xzxzzx/bilibili-mcp@1.14.5 항목이 없습니다
이 버전의 패키지 자체만 확인하며 모든 의존성은 아닙니다 · 확인 2026년 11월 15일
제작자라면 이 코드를 README에 붙여 넣으세요. 배지는 이 페이지로 연결됩니다.
[](https://mcp.popnx.com/en/servers/xzxzzx-ai-bilibili-mcp)질문하고, 팁을 나누고, 안 되는 점을 알려 주세요. "도움이 됨"이 많은 순서예요.
아직 리뷰가 없어요
레지스트리에서 이 카테고리의 활성 서버 전체와 비교했어요. 스타는 게시자가 저장소를 소유한 경우에만 세요.
해당하는 기본 점검 3개 중 3개를 통과했어요. 코드는 읽지 않았어요. 키나 토큰을 넣기 전에 서버가 어떤 권한을 요구하는지 확인하고, 꼭 필요한 권한만 있는 키를 쓰세요.
레지스트리에 필수 키가 나와 있지 않아요. 다만 처음 쓸 때 로그인을 요구하는 서버도 있어요.
내 컴퓨터에서 실행돼요. AI 앱이 필요할 때 실행하고, 데이터는 제작자의 서버를 거치지 않아요(서버 자체가 온라인 서비스를 호출하는 경우는 제외).
GitHub 저장소는 마지막으로 어제 변경됐고, 최신 버전(1.14.5)은 25일 전 레지스트리에 올라왔어요.
Claude Desktop, Claude Code, Cursor, VS Code처럼 MCP를 지원하는 앱에서 쓸 수 있어요. 내 컴퓨터에 Node.js도 있어야 해요.
같은 카테고리에는: HyperFrames by HeyGen, Pascal 3D Editor, draw.io, Figma MCP Server, Remocn: Remotion MCP server
같은 카테고리, 다른 제작자, 명령 확인 완료. 공식이 먼저, 그다음 스타 순.
카드 보는 법:↓ 주간 다운로드i★ GitHub 스타i세 기둥: 리뷰 · 점검 · 사용 정도i업데이트 = 최신 버전을 레지스트리에 공개한 날i
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.
| 이 항목 Bilibili MCP Server | HyperFrames by HeyGen | Pascal 3D Editor | draw.io | Figma MCP Server | Remocn: Remotion MCP server | |
|---|---|---|---|---|---|---|
| 실행 위치 | 컴퓨터에 설치 필요 | 클라우드에서 동작, 설치 불필요 | 클라우드 또는 컴퓨터 설치 모두 가능 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 | 클라우드에서 동작, 설치 불필요 |
| 키 필요 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 | 아니요 |
| Claude에서 +로 추가 | 아니요 | 예 | 아니요 | 아니요 | 예 | 아니요 |
| 기본 점검 | 3/3 | 4/4 | 5/5 | 4/4 | 4/4 | 4/4 |
| 라이선스 | Apache-2.0 | Apache-2.0 | MIT | Apache-2.0 | – | MIT |
| 가격 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 | 등록 정보에 비용 없음 |
제작자의 저장소에서 쓰인 그대로 가져왔어요. PopNx MCP가 검토하거나 보증한 내용이 아니에요. HTML, 이미지, 스크립트는 제거했어요. 링크를 누르면 이 사이트를 벗어나요.
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 开源。