bilinote-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BILI_COOKIE | No | Bilibili cookie string for authentication. Optional; takes priority over cookies.json and browser auto-read. If not provided, anonymous access or other sources are used. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| search_videosC | 综合搜索 B 站视频。返回 bvid/标题/UP主(mid)/播放数/时长/简介。 |
| get_video_infoA | 视频详情：标题/简介/UP主/分P列表（含每集 cid 与时长）。支持 BV 号或任意 B 站链接。 |
| get_video_subtitlesA | 取单集字幕正文（B 站已有 CC/AI 字幕时）。返回语言、分段(含时间戳)与全文。 没有字幕轨时报错——此时用 download_audio + asr_transcribe 现场转写。 |
| get_video_chaptersB | 视频章节（UP 主手动分段，来自播放器接口）。无章节返回空列表。是笔记的结构骨架。 |
| download_audioA | 直连下载视频的音频轨（m4s，选最低码率省流量）。为 asr_transcribe 备料； 需要完整音频文件时也可用 batch 工具或 bili-subtitle CLI 的 --audio。 |
| asr_transcribeA | 必剪 ASR 语音转字幕（无需登录）。audio_path 支持 flac/aac/m4a/mp3/wav； fmt: srt / lrc / txt / json / segments。长音频上传+识别可能需要 1-3 分钟。 |
| list_commentsB | 视频评论区（只读）。order: hot=热门, time=最新。高赞评论常含勘误与补充，做笔记前值得看。 |
| list_uploader_videosC | UP 主投稿列表。order: pubdate/click/stow。配合批量字幕可把整个 UP 主的课程转笔记。 |
| list_uploader_collectionsA | UP 主的合集/系列列表（课程大多以合集组织）。返回 id/name/total，配合 get_collection_videos 用。 |
| get_collection_videosB | 合集（season_id）或系列（series_id）内的视频列表，二选一。 |
| list_favorite_foldersA | 当前登录用户创建的收藏夹列表（需登录 Cookie）。 |
| list_favorite_videosB | 收藏夹内的视频列表（需登录 Cookie）。配合字幕/ASR 可把收藏夹整体转笔记。 |
| qr_login_startA | 开始扫码登录：返回二维码（图片内容 + PNG 路径 + ASCII 文本 + 原始链接）。 把二维码展示给用户，用 B 站 App 扫码并在手机上点确认； 然后用返回的 qrcode_key 调 qr_login_poll 轮询状态，confirmed 即登录成功 （保存的 cookies.json 会被后续需要登录的工具自动使用）。 render: "png"=返回图片内容与 PNG 路径（默认，推荐）； "ascii"=仅返回终端文本二维码；"none"=仅返回链接。 |
| qr_login_pollA | 查询扫码登录状态（waiting=未扫/scanned=已扫未确认/confirmed=成功）。 confirmed 时返回 cookies；提供 cookies_path 则同时保存到文件。 |
| batch_download_subtitlesA | 批量下载字幕（断点续跑，已存在自动跳过）。all_parts=True 下载全部分 P； fmt: text/srt/json；output 为输出文件路径（all_parts 时自动加 .pN 后缀）。 长任务可能耗时数分钟；返回结构化进度事件与结果汇总。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 15 tools
Each tool targets a distinct resource/action: search, video info, subtitles, chapters, audio download, ASR, comments, uploader/collection/favorite listing, and QR login. Even the subtitle-related tools are clearly separated by existing vs generated transcripts and single vs batch operations, with explicit cross-references.
Most tools follow a predictable verb_noun pattern with consistent list_favorite_ and list_uploader_ prefixes. Minor deviations like asr_transcribe and get_collection_videos (instead of list_collection_videos) break the pattern slightly, but the overall style remains readable and navigable.
With 15 tools, the server sits at the upper edge of the ideal range, and each tool maps to a concrete step in the video-to-notes workflow. There are no redundant or decorative tools, and the breadth is justified by the many ways Bilibili content can be discovered and collected.
The tool surface covers the full pipeline: search/discovery, video and chapter metadata, transcript acquisition via existing subtitles or ASR, comment context, batch collection/favorite workflows, and login support. Missing write operations are irrelevant for a read/extract server, so agents have no dead ends.