bilibili-mcp
B站(Bilibili)MCP Server —— 让 AI 助手直接操作B站。
支持 OpenClaw / Claude Code / Cursor / Cline 等所有 MCP 客户端。
27 个工具,覆盖登录认证、搜索采集、内容发布、数据分析、互动运营。
功能
登录认证
数据采集
内容发布
数据分析
互动运营
快速开始
1. 克隆项目
git clone https://github.com/adoresever/bilibili-mcp.git
cd bilibili-mcp
2. 安装依赖
pip install -r requirements.txt
需要 Python 3.10+,视频上传自动截取封面需要 ffmpeg。
3. 登录
方式一:通过 AI 工具登录(推荐)
接入 MCP 后,直接对 AI 说"登录B站",AI 会调用 bili_login 生成二维码展示给你扫码,全程无需终端操作。
方式二:命令行登录
python bili_login.py
4. 测试运行
npx @modelcontextprotocol/inspector python mcp_server.py
接入 AI 工具
OpenClaw
npm i -g mcporter
npx mcporter config add bilibili-mcp "python /path/to/bilibili-mcp/mcp_server.py"
或直接把 GitHub 链接粘贴到 OpenClaw 对话框,让它自动配置。
Claude Code
在项目目录创建 .mcp.json:
{
"mcpServers": {
"bilibili-mcp": {
"command": "python",
"args": ["/path/to/bilibili-mcp/mcp_server.py"]
}
}
}
Cursor / Cline
在设置中添加 MCP Server,command 填 python,args 填 mcp_server.py 的完整路径。
使用示例
接入后,你可以直接用自然语言让 AI 操作:
- "登录B站"(AI会展示二维码给你扫)
- "搜索B站上关于AI Agent的热门视频"
- "获取这个视频的评论,分析用户需求"
- "获取视频字幕,总结视频内容"
- "帮我回复这条评论"
- "批量采集OpenClaw相关视频的评论和字幕"
- "帮我发一条B站动态,配上这几张图片"
- "把这个视频上传到B站科技区"
- "看看B站现在什么最火"
- "获取科技区排行榜前10的视频"
- "分析这个UP主的粉丝和投稿数据"
- "我有多少未读私信和回复?"
- "看看我的收藏夹里有什么"
技术栈
- bilibili-api-python — B站 API 封装库,提供搜索、评论、字幕、弹幕等全部接口
- MCP (Model Context Protocol) — Anthropic 提出的开放协议,标准化 AI 与工具的交互
- FastMCP — MCP Python SDK,快速构建 MCP Server
项目结构
bilibili-mcp/
├── mcp_server.py # MCP Server 主文件(27个tool)
├── bili_login.py # 命令行扫码登录(备用)
├── bili_credential.json # 登录凭证(自动生成,勿提交)
├── requirements.txt # Python 依赖
├── README.md # 项目说明
├── LICENSE # MIT 开源协议
└── .gitignore # Git 忽略文件
注意事项
- 首次使用通过 AI 对话即可完成登录,无需终端操作
- 凭证保存在本地,不会上传
- 请求间隔自动控制,避免频率过快
- 回复评论/发私信功能请谨慎使用,遵守B站社区规则
- 视频上传未指定封面时,自动从视频第3秒截取(需要ffmpeg)
- 本项目仅用于学习和研究
License
MIT