Bilibili MCP Server

# Bilibili MCP Server 基于[bilibili-api](https://github.com/nemo2011/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 本项目 ```bash git clone <repository-url> cd bilibili-mcp-server ``` 2. 使用 pip 安装依赖 ```bash pip install -r requirements.txt playwright install chromium ``` 3. 在任意 mcp client 中配置本 Server ```json { "mcpServers": { "bilibili": { "command": "python", "args": ["/your-project-path/bilibili-mcp-server/bilibili_mcp_server.py"] } } } ``` 4. 在 client 中使用 ## 快速测试 使用 MCP Inspector 进行测试： ```bash # 安装 MCP Inspector npm install -g @modelcontextprotocol/inspector # 启动测试 mcp-inspector -- python bilibili_mcp_server.py ``` ## 使用示例 ### 搜索视频 ```json { "keyword": "Python教程", "topk": 10, "method": "api" } ``` ### 获取视频信息 ```json { "bvid": "BV1xx411c7mu", "method": "api" } ``` ### 获取评论 ```json { "bvid": "BV1xx411c7mu", "topk": 20, "include_replies": true, "reply_count": 5 } ``` ## 配置Cookies 如果需要获取评论功能，需要配置用户cookies： ```bash 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 # 开发日志 ```