Skip to main content
Glama
bilibili-mcp-server

bilibili-mcp-server

by Iseenope

Bilibili MCP Server

English | 中文

B 站的 MCP 服务。提供视频搜索、评论管理、弹幕字幕、用户信息、动态专栏、扫码登录、直播截图视觉分析等功能,共 31 个工具。

工具列表

类别

工具

数量

评论

bilibili_reply、bilibili_delete_comment、bilibili_like_comment

3

搜索

bilibili_search、bilibili_search_hot

2

视频

bilibili_video_info、bilibili_video_comments、bilibili_video_subtitle、bilibili_video_danmaku、bilibili_hot

5

用户

bilibili_user_info、bilibili_user_videos、bilibili_user_favorites、bilibili_user_follow、bilibili_user_unfollow、bilibili_user_followings、bilibili_user_followers

7

内容

bilibili_user_dynamics、bilibili_article_info、bilibili_user_articles

3

消息

bilibili_detect_replies、bilibili_notifications

2

直播

bilibili_live_info、bilibili_live_screenshot

2

登录

bilibili_login、bilibili_login_check

2

系统

bilibili_refresh_cookie

1

下载

bilibili_video_download、bilibili_article_download、bilibili_download_list

3

弹幕

bilibili_send_danmaku

1

Related MCP server: BiliStalkerMCP

快速开始

环境要求

  • Node.js 22+

  • B 站账号(用于需要登录的操作)

  • ffmpeg(仅视频下载工具需要;macOS: brew install ffmpeg,Windows: choco install ffmpeg,Linux: apt install ffmpeg)

安装

# 直接运行
npx bilibili-mcp-server

# 或全局安装
npm install -g bilibili-mcp-server
bilibili-mcp-server

配置

支持环境变量或项目目录下的 .env 文件:

# 必填 - 从浏览器开发者工具 → Application → Cookies → bilibili.com 获取
export BILIBILI_SESSDATA=你的sessdata
export BILIBILI_BILI_JCT=你的bili_jct
export BILIBILI_DEDE_USER_ID=你的uid

# 可选 - Cookie 自动刷新
# 获取方式: bilibili.com → F12 → Console → 输入:
#   console.log(localStorage.getItem('ac_time_value'))
export BILIBILI_REFRESH_TOKEN=你的refresh_token

# 可选 - 完整 Cookie(热搜等功能需要)
# export BILIBILI_FULL_COOKIE="buvid3=xxx; buvid4=xxx; _uuid=xxx; ..."

# 可选
export BILIBILI_AUTO_REFRESH=true
export BILIBILI_COOKIE_FILE=/path/to/cookie.json
export BILIBILI_DETECT_FILE=/path/to/detect.json

MCP 客户端配置

{
  "mcpServers": {
    "bilibili": {
      "command": "npx",
      "args": ["-y", "bilibili-mcp-server"],
      "env": {
        "BILIBILI_SESSDATA": "你的sessdata",
        "BILIBILI_BILI_JCT": "你的bili_jct",
        "BILIBILI_DEDE_USER_ID": "你的uid"
      }
    }
  }
}

扫码登录

不想手动复制 Cookie 的话,可以调扫码登录:

  1. 调 bilibili_login 获取二维码

  2. 手机 B 站 App 扫码

  3. 调 bilibili_login_check 检测登录状态

  4. 登录成功自动保存 Cookie

工具说明

登录与认证

工具

功能

参数

bilibili_login

生成扫码登录二维码

-

bilibili_login_check

轮询扫码状态,登录成功自动保存

loginKey, maxRetries?

bilibili_refresh_cookie

手动触发 Cookie 刷新

-

评论管理

工具

功能

参数

bilibili_reply

发布评论或回复

videoId, message, parentRpid?

bilibili_delete_comment

删除自己的评论

videoId, rpid

bilibili_like_comment

点赞/取消赞

videoId, rpid, action

视频与搜索

工具

功能

参数

bilibili_search

搜索视频

keyword, order?, page?, duration?

bilibili_video_info

视频详情

videoId

bilibili_video_comments

获取评论列表

videoId, max?

bilibili_video_subtitle

获取字幕

videoId, lang?

bilibili_video_danmaku

获取弹幕

videoId, segment?

bilibili_hot

热门视频

page?, max?

bilibili_search_hot

热搜关键词

-

用户

工具

功能

参数

bilibili_user_info

用户信息

uid

bilibili_user_videos

UP 主视频列表

uid, max?

bilibili_user_favorites

收藏夹

uid, folderId?, max?

动态与专栏

工具

功能

参数

bilibili_user_dynamics

UP 主最新动态

uid, max?

bilibili_article_info

专栏文章详情

cvid

bilibili_user_articles

UP 主专栏列表

uid, max?

关注管理

工具

功能

参数

bilibili_user_follow

关注 UP 主

uid

bilibili_user_unfollow

取消关注

uid

bilibili_user_followings

关注列表

uid, page?, pageSize?

bilibili_user_followers

粉丝列表

uid, page?, pageSize?

关注/取关操作会被 B 站风控监控,不建议短时间内大量操作。

弹幕

工具

功能

参数

bilibili_send_danmaku

发送弹幕

videoId, cid, progress, message, color?, mode?

弹幕发送是高风控操作,建议每天不超过 5 条。

下载

工具

功能

参数

bilibili_video_download

下载视频(需 ffmpeg)

videoId, cid?, quality?, outputDir?

bilibili_article_download

下载专栏为 Markdown

cvid, outputDir?, downloadImages?

bilibili_download_list

查看已下载列表

outputDir?

视频下载会自动下载 DASH 音视频并用 ffmpeg 合并为 mp4。默认保存到 ./bilibili-downloads/。

消息通知

工具

功能

参数

bilibili_detect_replies

检测新回复

max?

bilibili_notifications

查看未读通知

-

直播

工具

功能

参数

bilibili_live_info

查询直播间信息

uid

bilibili_live_screenshot

截取直播间当前画面(视觉分析)

uid

bilibili_live_screenshot 会把关键帧截图作为图片返回给模型,让具备视觉能力的 AI 分析直播内容。如模型无视觉能力,仅返回文字元数据。

项目结构

src/
├── index.ts
├── env.ts
├── config.ts
├── api/
│   ├── http.ts
│   ├── bilibili.ts
│   ├── wbi.ts
│   ├── cookie.ts
│   ├── login.ts
│   └── danmaku.ts
├── tools/
│   ├── comment.ts
│   ├── video.ts
│   ├── user.ts
│   ├── content.ts
│   ├── message.ts
│   ├── login.ts
│   └── live.ts
└── types/
    └── index.ts

开发

npm install
npm run dev    # 开发模式
npm run build  # 构建
npm test       # 测试

许可证

MIT

Available Tools

21 tools
bilibili_article_infoB

获取 B站 专栏文章的详细内容,包含标题、正文、发布时间、作者、数据统计等

Inputs: cvid (required).

bilibili_detect_repliesA

检测 B站视频/评论下的新回复,列出上次检查之后的新内容。不自动回复,需要人工确认后操作。

Inputs: max, videoId.

bilibili_download_listA

查看已下载的文件列表(按时间倒序)

Inputs: outputDir.

bilibili_hotC

获取 B站当前热门视频列表,包含播放量、弹幕数、点赞数等数据

Inputs: max, page.

bilibili_live_infoB

查询 B站 UP 主的直播间信息。输入 uid(用户 ID),返回直播状态(是否开播)、直播间标题、人气值(热度)、关注数、直播分类、弹幕热词等。注意:人气值是热度指标,非真实观看人数

Inputs: uid (required).

bilibili_loginA

生成 B站 扫码登录二维码。返回二维码图片(Base64)和 login_key,将 login_key 传给 bilibili_login_check 检查登录状态

Inputs: no named parameters.

bilibili_login_checkA

检查 B站 扫码登录状态。调用 bilibili_login 获取二维码后,传入返回的 loginKey 进行轮询检查。扫码成功后自动保存 Cookie

Inputs: loginKey (required), maxRetries.

bilibili_notificationsA

查看 B站未读消息概览,包含回复、@提及、点赞等通知

Inputs: no named parameters.

bilibili_replyC

在 B站视频下发布评论或回复他人评论

Inputs: message (required), videoId (required), type, rootRpid, +1 more.

bilibili_search_hotA

获取 B站热搜关键词列表

Inputs: no named parameters.

bilibili_send_danmakuA

向视频发送一条弹幕。B 站对此操作有极严格的风控,新账号或操作频繁的账号可能直接被风控拦截。建议每天不超过 5 条。

Inputs: cid (required), message (required), videoId (required), progress (required), +2 more.

bilibili_user_articlesB

获取指定 UP 主发布的专栏文章列表,包含阅读数、发布时间等

Inputs: uid (required), max.

bilibili_user_dynamicsA

获取指定 UP 主的最新动态(包括视频投稿、转发、图文等)

Inputs: uid (required), max.

bilibili_user_followersB

查询指定用户的粉丝列表(谁关注了 TA)

Inputs: uid (required), page, pageSize.

bilibili_user_infoA

获取 B站用户信息,包含昵称、签名、等级、粉丝数、关注数、直播间信息等

Inputs: uid (required).

bilibili_video_commentsA

获取 B站视频的评论列表,包含评论内容、作者信息、点赞数等

Inputs: videoId (required), max.

bilibili_video_danmakuB

获取 B站视频的弹幕列表,包含弹幕内容、出现时间、类型、颜色等

Inputs: videoId (required), segment.

bilibili_video_downloadA

下载 B 站视频到本地。自动下载视频+音频并用 ffmpeg 合并为 MP4。要求系统已安装 ffmpeg。⚠️ 仅供个人备份使用,请勿传播。

Inputs: videoId (required), cid, quality, outputDir.

bilibili_video_infoB

获取 B站视频的详细信息,包含标题、简介、播放量、弹幕数、评论数、点赞数、投币数、收藏数、分享数等

Inputs: videoId (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 21 tools

    Disambiguation4/5

    Most tools target distinct resources (videos, users, articles, live, auth), making selection generally clear. Minor ambiguity exists between bilibili_hot vs bilibili_search_hot and bilibili_notifications vs bilibili_detect_replies, but descriptions resolve the differences.

    Naming Consistency3/5

    All tools share the bilibili_ prefix, but the pattern is mixed: some are resource_noun (video_info, user_followers), some are verb-only (search, hot, reply), and pairing is inconsistent (video_download vs download_list, search_hot vs hot). Still readable, but not a uniform verb_noun convention.

    Tool Count4/5

    21 tools is on the heavy side, but the server covers a broad Bilibili surface including auth, videos, users, articles, live, and downloads. Each tool has a concrete purpose, so the count feels slightly over a lean scope rather than bloated.

    Completeness3/5

    Coverage is solid for read operations and basic interactions (comments, danmaku, downloads), and auth is fully handled. Notable gaps exist: bilibili_search explicitly references a bilibili_user_videos tool that does not exist, and there are no like/coin/favorite, follow/unfollow, or comment moderation tools, leaving some workflows incomplete.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      B
      maintenance
      An MCP server that enables users to search Bilibili videos, access trending rankings, and retrieve detailed information about videos, content creators, and anime schedules. It allows AI applications to interact directly with Bilibili content via simple API interfaces.
      102 npm
      198
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      BiliStalkerMCP is a Bilibili MCP server designed to analyze a specific Bilibili user by providing tools to retrieve user profiles, videos, dynamics, articles, and followings.
      126 PyPI
      11
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for interacting with Bilibili, enabling AI assistants to search videos, fetch comments and subtitles, publish content, and manage interactions. It also adds private message reading, stable TV login, and an automated comment workflow requiring human confirmation.
      MIT