Bilibili MCP Python

Bilibili MCP Server

基于 bilibili-api-python 库的 MCP (Model Context Protocol) 服务器，提供完整的 Bilibili API 工具调用能力。

特性

• 22个实用工具，覆盖视频、用户、搜索、评论、排行榜、消息等核心功能
• 使用 stdio 传输方式，与 Claude Desktop 无缝集成
• 支持环境变量配置登录凭证，安全便捷
• 统一的响应格式，易于处理
• 完整的类型注解和参数验证

配置

环境变量

复制 .env.example 为 .env 并填写：

# Bilibili 登录凭证（可选，用于需要登录的操作）
BILI_SESSDATA=your_sessdata
BILI_JCT=your_bili_jct
BILI_BUVID3=your_buvid3

获取登录凭证：

1. 登录 Bilibili 网页版
2. 打开浏览器开发者工具 (F12) → Application/应用 → Cookies
3. 复制 SESSDATA, bili_jct, buvid3 的值

Claude Desktop 配置

在 Claude Desktop 配置文件 claude_desktop_config.json 中添加：

uvx 方式配置（推荐）

{
  "mcpServers": {
    "bilibili": {
      "command": "uvx",
      "args": ["--from", "bilibili-mcp-python", "bilibili-mcp"],
      "env": {
        "BILI_SESSDATA": "your_sessdata",
        "BILI_JCT": "your_bili_jct",
        "BILI_BUVID3": "your_buvid3"
      }
    }
  }
}

工具详解

视频模块（Video）

视频相关操作，包含信息获取、互动、弹幕等功能。

使用示例：

# 获取视频信息
bilibili_video_get_info(bvid="BV1xx411c7mD")

# 给视频三连
bilibili_video_interact(bvid="BV1xx411c7mD", action="triple")

# 发送弹幕（视频第10秒处）
bilibili_video_send_danmaku(
    bvid="BV1xx411c7mD",
    message="精彩！",
    progress=10000,  # 毫秒
    color="ff0000"
)

用户模块（User）

用户信息查询和关系管理。

content_type 类型说明：

• video - 视频（支持关键词搜索）
• article - 专栏文章
• album - 相簿
• bangumi - 追番列表

使用示例：

# 获取UP主信息
bilibili_user_get_info(uid=208259)

# 获取用户的所有视频
bilibili_user_get_contents(uid=208259, content_type="video")

# 关注用户
bilibili_user_modify_relation(uid=208259, action="follow")

搜索模块（Search）

全网内容搜索和热门发现。

search_type 类型说明：

• all - 综合搜索
• video - 视频
• user - 用户
• article - 专栏
• live - 直播

使用示例：

# 搜索视频
bilibili_search(keyword="Python教程", search_type="video")

# 搜索用户
bilibili_search(keyword="老番茄", search_type="user")

# 获取热搜榜
bilibili_get_hot_search()

评论模块（Comment）

视频、动态、专栏的评论管理。

type_ 类型说明：

• video - 视频（oid为aid）
• dynamic - 动态（oid为动态id）
• article - 专栏（oid为cv号）

使用示例：

# 获取视频评论（首次）
bilibili_comment_get(oid=170001, type_="video", mode="main")

# 回复评论（root为评论ID）
bilibili_comment_send(
    oid=170001,
    type_="video",
    text="说得好！",
    root=12345678
)

# 点赞评论
bilibili_comment_operate(oid=170001, rpid=12345678, action="like")

排行榜模块（Rank）

各类排行榜和热门视频获取。

rank_type 排行榜类型：

使用示例：

# 获取全站排行榜
bilibili_get_rank(rank_type="all")

# 获取游戏区三日榜
bilibili_get_rank(rank_type="game", day=3)

# 获取热门视频
bilibili_get_hot(page=1, page_size=20)

消息会话模块（Session）

私信、互动消息和系统通知管理。

interaction_type 互动类型：

• replies - 收到的回复
• likes - 收到的赞
• at - @我的消息

notification_type 通知类型：

• unread - 未读消息统计
• system - 系统消息
• settings - 消息设置

使用示例：

# 获取会话列表
bilibili_session_list()

# 获取与某用户的聊天记录
bilibili_session_list(talker_id=208259)

# 发送私信
bilibili_session_send(receiver_id=208259, content="你好！")

# 获取收到的赞
bilibili_session_interactions(interaction_type="likes")

# 获取未读消息数
bilibili_session_notifications(notification_type="unread")

响应格式

所有工具返回统一的 JSON 格式：

{
  "success": true,
  "code": 0,
  "message": "ok",
  "data": { ... }
}

工具权限速查

无需登录（只读操作）

• 视频信息、弹幕、下载链接
• 用户信息、用户公开内容
• 搜索、热搜、排行榜、热门视频
• 评论列表

需要登录（写入操作）

• 视频互动（点赞/投币/收藏/三连）
• 发送弹幕、获取AI总结
• 关注/取关/拉黑等用户关系操作
• 发送评论、评论互动
• 所有消息会话相关操作