MCP 服务器

Bilibili API MCP Server

Enables interaction with Bilibili (哔哩哔哩) through its API, supporting video search and recommendations, user search, dynamic feeds, video collections, and danmaku retrieval through natural language.

README

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 文件作为配置参考。

方式二：本地开发运行

clone 本项目

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

使用 uv 安装依赖

uv sync

在任意 MCP client 中配置本 Server

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

开始使用

支持的操作

支持以下操作：

基础搜索功能

search_and_recommend_videos: 智能视频搜索和推荐功能。
- 按综合排序搜索视频内容
- 自动过滤课堂视频（cheese链接）
- 返回前15条视频结果（可自定义数量）
- 基于搜索结果提供推荐理由
- 分析视频质量和热度
- 生成内容总结和推荐报告
search_user: 专门用于搜索哔哩哔哩用户的功能，可以按照粉丝数排序。
get_user_id_by_name: 通过用户名获取用户ID，支持精确搜索和详细信息返回。
- 默认模式：只返回用户ID，用于快速获取用户标识
- 详细模式：返回完整用户信息和精确匹配状态
- 精确匹配：优先返回完全匹配用户名的结果
- 错误处理：提供详细的错误信息和异常处理

用户内容获取功能

get_user_dynamics: 获取指定用户的最新动态。
- 支持通过用户名直接获取（如"技术爬爬虾"）
- 可指定获取动态数量（默认10条）
- 返回动态内容、时间戳、链接等信息
get_user_videos: 获取指定用户的最新投稿视频。
- 支持通过用户名直接获取
- 可指定获取视频数量（默认10条）
- 返回视频标题、BV号、播放量、时长等详细信息
get_user_collections: 获取指定用户的合集信息。
- 支持通过用户名直接获取
- 返回合集标题、视频数量、播放量等信息
- 包含合集链接便于访问
get_collection_videos: 获取指定合集中的视频列表。
- 支持通过合集名称或合集ID获取
- 可指定获取视频数量（默认10条）
- 返回视频详细信息（标题、播放量、点赞数、投币数等）
- 支持模糊匹配合集名称
search_collection_by_keyword: 在用户合集中搜索包含关键词的视频。
- 支持在所有合集中搜索特定关键词
- 返回匹配的合集及其视频列表
- 适用于快速定位特定主题的视频内容