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获取登录凭证：
- 登录 Bilibili 网页版
- 打开浏览器开发者工具 (F12) → Application/应用 → Cookies
- 复制
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: BV号 | 否 | | bilibili_video_interact | 点赞/投币/收藏/三连 | bvid, action, cancel | 是 | | bilibili_video_get_download_info | 获取下载链接和清晰度 | bvid, page_num | 否 | | bilibili_video_get_danmaku | 获取弹幕列表 | bvid, page_num, from_seg | 否 | | bilibili_video_send_danmaku | 发送弹幕 | bvid, message, progress | 是 | | bilibili_video_get_ai_conclusion | 获取AI视频总结 | bvid | 是 |
使用示例： ```python
获取视频信息
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）
用户信息查询和关系管理。
| 工具名 | 功能 | 关键参数 | 需登录 | |--------|------|----------|--------| | bilibili_user_get_info | 获取用户完整信息 | uid: 用户UID | 否 | | bilibili_user_get_contents | 获取用户发布的内容 | uid, content_type | 否 | | bilibili_user_modify_relation | 关注/取关/拉黑/移除粉丝 | uid, action | 是 | | bilibili_user_get_followings | 获取关注列表 | uid, page_num | 是 | | bilibili_user_get_followers | 获取粉丝列表 | uid, page_num | 是 |
content_type 类型说明：
video- 视频（支持关键词搜索）article- 专栏文章album- 相簿bangumi- 追番列表
使用示例： ```python
获取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）
全网内容搜索和热门发现。
| 工具名 | 功能 | 关键参数 | 需登录 | |--------|------|----------|--------| | bilibili_search | 统一搜索 | keyword, search_type | 否 | | bilibili_get_hot_search | 获取热门搜索词 | 无 | 否 |
search_type 类型说明：
all- 综合搜索video- 视频user- 用户article- 专栏live- 直播
使用示例： ```python
搜索视频
bilibili_search(keyword="Python教程", search_type="video")
搜索用户
bilibili_search(keyword="老番茄", search_type="user")
获取热搜榜
bilibili_get_hot_search() ```
---
评论模块（Comment）
视频、动态、专栏的评论管理。
| 工具名 | 功能 | 关键参数 | 需登录 | |--------|------|----------|--------| | bilibili_comment_get | 获取评论列表（懒加载） | oid, type_, mode, offset | 否 | | bilibili_comment_send | 发送评论/回复 | oid, text, root | 是 | | bilibili_comment_operate | 点赞/点踩/删除/获取子评论 | oid, rpid, action | 是 |
type_ 类型说明：
video- 视频（oid为aid）dynamic- 动态（oid为动态id）article- 专栏（oid为cv号）
使用示例： ```python
获取视频评论（首次）
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）
各类排行榜和热门视频获取。
| 工具名 | 功能 | 关键参数 | 需登录 | |--------|------|----------|--------| | bilibili_get_rank | 获取分区排行榜 | rank_type, day | 否 | | bilibili_get_hot | 获取热门视频 | page, page_size | 否 |
rank_type 排行榜类型：
| 类型值 | 说明 | 类型值 | 说明 | |--------|------|--------|------| | all | 全站榜 | game | 游戏 | | bangumi | 番剧 | music | 音乐 | | movie | 电影 | douga | 动画 | | documentary | 纪录片 | ent | 娱乐 | | guochuang | 国创 | life | 生活 | | technology | 科技数码 | food | 美食 | | knowledge | 知识 | sports | 运动 | | dance | 舞蹈 | kichiku | 鬼畜 | | original | 原创 | rookie | 新人 | | ... | 还有更多 | | |
使用示例： ```python
获取全站排行榜
bilibili_get_rank(rank_type="all")
获取游戏区三日榜
bilibili_get_rank(rank_type="game", day=3)
获取热门视频
bilibili_get_hot(page=1, page_size=20) ```
---
消息会话模块（Session）
私信、互动消息和系统通知管理。
| 工具名 | 功能 | 关键参数 | 需登录 | |--------|------|----------|--------| | bilibili_session_list | 获取会话列表/聊天记录 | talker_id, session_type | 是 | | bilibili_session_send | 发送私信 | receiver_id, content | 是 | | bilibili_session_interactions | 获取互动消息 | interaction_type | 是 | | bilibili_session_notifications | 获取通知/未读统计 | notification_type | 是 |
interaction_type 互动类型：
replies- 收到的回复likes- 收到的赞at- @我的消息
notification_type 通知类型：
unread- 未读消息统计system- 系统消息settings- 消息设置
使用示例： ```python
获取会话列表
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": { ... }
}| 字段 | 类型 | 说明 | |------|------|------| | success | boolean | 是否成功 | | code | int | 状态码，0表示成功 | | message | string | 状态描述或错误信息 | | data | any | 实际返回数据 |
---
工具权限速查
无需登录（只读操作）
- 视频信息、弹幕、下载链接
- 用户信息、用户公开内容
- 搜索、热搜、排行榜、热门视频
- 评论列表
需要登录（写入操作）
- 视频互动（点赞/投币/收藏/三连）
- 发送弹幕、获取AI总结
- 关注/取关/拉黑等用户关系操作
- 发送评论、评论互动
- 所有消息会话相关操作
---
