Bilibili API MCP Server

用于哔哩哔哩 API 的 MCP（模型上下文协议）服务器，支持多种操作。

环境要求

• uv - 一个项目管理工具，可以很方便管理依赖。

使用方法

方式一：通过 PyPI 使用（推荐）

在任意 MCP client 中配置本 Server，系统会自动下载和启用

{
  "mcpServers": {
    "bilibili": {
      "type": "stdio",
      "isActive": true,
      "command": "uvx",
      "args": [
        "bilibili-api-mcp-server"
      ]
    }
  }
}

💡 提示：您也可以直接使用项目根目录下的 mcp-config.json 文件作为配置参考。

方式二：本地开发运行

1. clone 本项目

git clone https://github.com/SMYB5431/bilibili-api-mcp-server.git
cd bilibili-api-mcp-server

1. 使用 uv 安装依赖

uv sync

1. 在任意 MCP client 中配置本 Server

{
  "mcpServers": {
    "bilibili": {
      "command": "uvx",
      "args": [
        "--directory",
        "/your-project-path/bilibili-api-mcp-server",
        "run",
        "bilibili.py"
      ]
    }
  }
}

开始使用

支持的操作

支持以下操作：

基础搜索功能

1. search_and_recommend_videos: 智能视频搜索和推荐功能。

   • 按综合排序搜索视频内容
   • 自动过滤课堂视频（cheese链接）
   • 返回前15条视频结果（可自定义数量）
   • 基于搜索结果提供推荐理由
   • 分析视频质量和热度
   • 生成内容总结和推荐报告

2. search_user: 专门用于搜索哔哩哔哩用户的功能，可以按照粉丝数排序。

3. get_user_id_by_name: 通过用户名获取用户ID，支持精确搜索和详细信息返回。

   • 默认模式：只返回用户ID，用于快速获取用户标识
   • 详细模式：返回完整用户信息和精确匹配状态
   • 精确匹配：优先返回完全匹配用户名的结果
   • 错误处理：提供详细的错误信息和异常处理

用户内容获取功能

1. get_user_dynamics: 获取指定用户的最新动态。

   • 支持通过用户名直接获取（如"技术爬爬虾"）
   • 可指定获取动态数量（默认10条）
   • 返回动态内容、时间戳、链接等信息

2. get_user_videos: 获取指定用户的最新投稿视频。

   • 支持通过用户名直接获取
   • 可指定获取视频数量（默认10条）
   • 返回视频标题、BV号、播放量、时长等详细信息

3. get_user_collections: 获取指定用户的合集信息。

   • 支持通过用户名直接获取
   • 返回合集标题、视频数量、播放量等信息
   • 包含合集链接便于访问

4. get_collection_videos: 获取指定合集中的视频列表。

   • 支持通过合集名称或合集ID获取
   • 可指定获取视频数量（默认10条）
   • 返回视频详细信息（标题、播放量、点赞数、投币数等）
   • 支持模糊匹配合集名称

5. search_collection_by_keyword: 在用户合集中搜索包含关键词的视频。

   • 支持在所有合集中搜索特定关键词
   • 返回匹配的合集及其视频列表
   • 适用于快速定位特定主题的视频内容

其他功能

1. get_video_danmaku: 获取视频弹幕信息。
   • 支持视频链接或BV号输入
   • 自动从链接中提取BV号
   • 支持多分P视频的弹幕获取
   • 返回详细的视频信息和弹幕数据

声明

本项目在开发和测试过程中使用了哔哩哔哩 UP主 技术爬爬虾 的公开内容作为示例数据。

本项目仅用于技术学习和研究目的，所有示例数据的使用均遵循哔哩哔哩平台的使用条款。如有任何版权问题，请联系项目维护者。

License

MIT