yixiaowang2001/bilibili-mcp-server

Bilibili MCP Server

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

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 包管理器

使用方法

1. clone 本项目

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

2. 使用 pip 安装依赖

pip install -r requirements.txt
playwright install chromium

3. 在任意 mcp client 中配置本 Server

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

4. 在 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使用规范，避免过度请求

故障排除

1. 412错误: 请求被拒绝

   • 解决方案：检查cookies是否有效，尝试使用script方法

2. 超时错误: 请求超时

   • 解决方案：检查网络连接，减少请求数量

3. 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              # 开发日志