Bilibili MCP Server

基于bilibili-api和Playwright的B站MCP Server，关注于数据获取，支持多种相关操作。

Demo with Cursor

demo_with_cursor

工具列表

search_videos: 搜索视频，支持关键词搜索，可指定返回数量和方法（API/网页抓取）
search_articles: 搜索专栏文章，使用网页抓取方式获取真实数据
get_video_info: 获取视频详细信息，包括统计数据、UP主信息、标签等（API/网页抓取）
get_danmaku: 获取视频弹幕信息，返回XML格式数据
get_comments: 获取视频评论，支持嵌套回复和数量控制（需要cookies）
get_article: 获取专栏文章详细内容和相关数据

如果API获取失败，可以使用脚本方法（method = "script")尝试获取。

环境要求

Python 3.8+
pip 包管理器

使用方法

clone 本项目

git clone <repository-url> cd bilibili-mcp-server

使用 pip 安装依赖

pip install -r requirements.txt playwright install chromium

在任意 mcp client 中配置本 Server

{ "mcpServers": { "bilibili": { "command": "python", "args": ["/your-project-path/bilibili-mcp-server/bilibili_mcp_server.py"] } } }

在 client 中使用

快速测试

使用 MCP Inspector 进行测试：

# 安装 MCP Inspector npm install -g @modelcontextprotocol/inspector # 启动测试 mcp-inspector -- python bilibili_mcp_server.py

使用示例

搜索视频

{ "keyword": "Python教程", "topk": 10, "method": "api" }

获取视频信息

{ "bvid": "BV1xx411c7mu", "method": "api" }

获取评论

{ "bvid": "BV1xx411c7mu", "topk": 20, "include_replies": true, "reply_count": 5 }

配置Cookies

如果需要获取评论功能，需要配置用户cookies：

python cookies_tool.py

按照提示操作即可自动保存cookies。

注意事项

请求频率: 已添加请求延迟，避免触发反爬机制
Cookies: 获取评论功能需要有效的用户cookies
网络环境: 确保网络连接稳定
API限制: 遵循B站API使用规范，避免过度请求

故障排除

412错误: 请求被拒绝
- 解决方案：检查cookies是否有效，尝试使用script方法
超时错误: 请求超时
- 解决方案：检查网络连接，减少请求数量
Playwright错误: 专栏搜索失败
- 解决方案：运行 playwright install chromium 安装浏览器

项目结构

bili-mcp_backup/ ├── bilibili_mcp_server.py # MCP服务器主文件 ├── bilibili_client.py # B站API客户端 ├── bilibili_cookies.json # 用户cookies配置 ├── mcp_config.json # MCP配置文件 ├── cookies_tool.py # Cookies管理工具 ├── requirements.txt # 依赖包 ├── README.md # 项目说明 └── 开发日志.md # 开发日志