An MCP server to fetch Bilibili video information like subtitles, comments, and danmaku.
Project description
Bilibili 视频信息 MCP 服务器
这是一个基于 MCP (Model Context Protocol) 的服务器,可以获取 Bilibili 视频的字幕、弹幕和评论信息。
功能特点
- 支持获取 Bilibili 视频字幕列表
- 支持获取 Bilibili 视频弹幕内容
- 支持获取 Bilibili 视频热门评论
- 基于 FastMCP 框架,轻量化设计
- 通过环境变量配置 SESSDATA
安装要求
- Python >= 3.10
- 依赖包:requests、mcp[cli]
安装方法
从 PyPI 安装 (推荐)
# 使用pip安装
pip install bilibili-video-info-mcp
# 或者使用 uv 安装
uv pip install bilibili-video-info-mcp
从源码安装
# 克隆仓库
git clone <仓库地址>
cd bilibili-video-info-mcp
# 安装依赖
pip install -e .
# 或者使用 uv
uv pip install -e .
环境变量配置
使用前需要设置 Bilibili 的 SESSDATA 环境变量。SESSDATA 可以从浏览器的 Cookie 中获取。
# 设置环境变量
export SESSDATA="你的SESSDATA值"
使用方法
启动服务器
# 使用模块方式启动
python -m bilibili_video_info_mcp
# 或者使用安装的命令行工具
bilibili-video-info-mcp
使用 MCP Inspector 调试
# 使用 npx 安装并运行 MCP Inspector
npx -y @modelcontextprotocol/inspector uv run mcp_server.py
这将启动 MCP Inspector 界面,您可以在浏览器中测试 MCP 工具。
API 功能
1. 获取视频字幕列表
{
"name": "get_subtitles",
"arguments": {
"url": "https://www.bilibili.com/video/BV1x341177NN"
}
}
2. 获取视频弹幕
{
"name": "get_danmaku",
"arguments": {
"url": "https://www.bilibili.com/video/BV1x341177NN"
}
}
3. 获取视频评论
{
"name": "get_comments",
"arguments": {
"url": "https://www.bilibili.com/video/BV1x341177NN"
}
}
集成到其他应用
MCP 服务器可以通过标准输入输出 (stdio) 与其他应用集成,也可以作为独立的 HTTP 服务运行。
在 AI 助手中使用
适用于 Claude、GPT 等 AI 助手的 MCP 集成,可以让 AI 助手获取 Bilibili 视频的字幕、弹幕和评论数据。
常见问题
1. 找不到 SESSDATA 怎么办?
- 登录 Bilibili 网站
- 打开浏览器开发者工具 (F12)
- 进入 Application/Storage -> Cookies
- 找到 SESSDATA 对应的值
2. 报错 "SESSDATA environment variable is required"
确保已经设置了环境变量:
export SESSDATA="你的SESSDATA值"
3. 视频链接支持哪些格式?
支持标准的 Bilibili 视频链接,例如:
- https://www.bilibili.com/video/BV1x341177NN
- https://b23.tv/xxxxx (短链接)
- 包含 BV 号的任何链接
许可证
MIT
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file bilibili_video_info_mcp-0.1.0.tar.gz.
File metadata
- Download URL: bilibili_video_info_mcp-0.1.0.tar.gz
- Upload date:
- Size: 5.8 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.10.18
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
424627fa177bc06caba0d9e66c9c6cfe35b745f4fe164ff13645603b30ca67cf
|
|
| MD5 |
e62de9573d14c99c097dbd1f7c5971d0
|
|
| BLAKE2b-256 |
1db07285a457b7151584540d71cd87de1d590abc304ffa3e1f6d1d2214ebccd1
|
File details
Details for the file bilibili_video_info_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: bilibili_video_info_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 7.3 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.10.18
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
5008519d1fd3f28d7cb1c58517b3a07910adaf3608f408272e43ea67052f476a
|
|
| MD5 |
305abe132d3aa00124e579452e5346f3
|
|
| BLAKE2b-256 |
a3d5aef5559013504012edceac10f41172f6b5643658e3c909afb421505be96b
|