bilibili-mcp

B站（Bilibili）MCP Server —— 让 AI 助手直接操作B站。

支持 OpenClaw / Claude Code / Cursor / Cline 等所有 MCP 客户端。

27 个工具，覆盖登录认证、搜索采集、内容发布、数据分析、互动运营。

功能

登录认证

数据采集

内容发布

数据分析

互动运营

Related MCP server: MediaCrawler MCP Server

快速开始

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