bili-subtitle-mcp

一个 MCP（Model Context Protocol） 服务器，让 Claude Desktop、Cursor 等 AI 客户端可以直接"看"B站视频：获取视频信息、热门评论和字幕。

无需任何 API Key，全部数据来自 B 站网页版公开接口。

功能

Related MCP server: Bilibili API MCP Server

快速开始

pip install .

在 MCP 客户端中注册（以 Claude Desktop 为例，claude_desktop_config.json）：

{
  "mcpServers": {
    "bili-video": {
      "command": "bili-subtitle-mcp"
    }
  }
}

之后就可以直接对 AI 说：

帮我看看这个视频讲了什么：https://www.bilibili.com/video/BV1GJ411x7h7

AI 会自动调用工具获取视频信息和字幕，再给你总结。

已知限制

• 字幕：未登录状态下只能获取 UP 主手动上传的 CC 字幕。B 站 AI 生成字幕需要登录态，暂不支持（见路线图）。

• 弹幕：B 站弹幕接口已迁移到 protobuf 协议，暂未支持（见路线图）。

• 频率限制：本服务器对 B 站接口只做只读访问且自带间隔，请勿高频滥用；数据版权归 B 站与 UP 主所有，仅供个人学习研究。

路线图

• 支持 SESSDATA 环境变量（可选），解锁 AI 字幕

• 弹幕获取（protobuf 协议解析），支持按时间轴分析高能片段

• 分 P 视频（多 cid）支持

• 视频合集 / 收藏夹批量分析

开发

pip install .
python -m unittest discover -s tests -v

注意：editable 安装（pip install -e .）在含中文/非 ASCII 的路径下有已知问题，请使用上面的普通安装方式。

项目结构：

src/bili_mcp/
├── bilibili.py   # B站公开接口客户端（BV号解析、视频信息、评论、字幕）
├── server.py     # MCP 工具层（4 个工具的定义与文本格式化）
└── __main__.py   # 命令行入口
tests/            # 单元测试（不依赖网络）

License

MIT