MCP 服务器

bilibili-mcp

A Model Context Protocol server that provides tools for parsing and retrieving Bilibili video information, including video details, download links, and collection listings.

README

Bilibili MCP Server

一个用于解析哔哩哔哩（Bilibili）视频的 Model Context Protocol (MCP) 服务器，支持视频信息提取、下载链接获取和合集解析等功能。

功能特性

✅ 解析 Bilibili 视频链接（支持 b23.tv 短链接）
✅ 获取视频详细信息（标题、封面、简介、用户信息等）
✅ 获取视频下载链接（1080P 画质）
✅ 支持合集视频解析
✅ 获取合集视频列表

安装

方式一：使用 npx（推荐）

无需安装，直接运行：

{
  "mcpServers": {
    "bilibili": {
      "command": "npx",
      "args": ["-y", "mcp-server-bilibili"]
    }
  }
}

方式二：全局安装

npm install -g mcp-server-bilibili

然后在配置文件中使用：

{
  "mcpServers": {
    "bilibili": {
      "command": "mcp-server-bilibili"
    }
  }
}

方式三：从源码运行

# 克隆仓库
git clone https://github.com/fysh1010/bilibili-mcp.git
cd bilibili-mcp

# 安装依赖
npm install

# 构建
npm run build

然后在配置文件中使用：

{
  "mcpServers": {
    "bilibili": {
      "command": "node",
      "args": ["E:\\path\\to\\bilibili-mcp\\build\\index.js"]
    }
  }
}

配置 Claude Desktop

Windows

打开 Claude Desktop 配置文件：

%APPDATA%\Claude\claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "bilibili": {
      "command": "npx",
      "args": ["-y", "mcp-server-bilibili"]
    }
  }
}

重启 Claude Desktop

macOS

打开 Claude Desktop 配置文件：

~/Library/Application Support/Claude/claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "bilibili": {
      "command": "npx",
      "args": ["-y", "mcp-server-bilibili"]
    }
  }
}

重启 Claude Desktop

Linux

打开 Claude Desktop 配置文件：

~/.config/Claude/claude_desktop_config.json

添加以下配置：

{
  "mcpServers": {
    "bilibili": {
      "command": "npx",
      "args": ["-y", "mcp-server-bilibili"]
    }
  }
}

重启 Claude Desktop

可用工具

1. parse_bilibili_video

解析 Bilibili 视频链接，获取完整信息。

参数：

url (必填): Bilibili 视频链接，支持 b23.tv 短链接

示例：

请解析这个 Bilibili 视频：https://b23.tv/XhtfoyZ

返回数据：

{
  "code": 200,
  "msg": "解析成功！",
  "data": {
    "title": "视频标题",
    "cover": "封面图片URL",
    "description": "视频简介",
    "url": "视频下载链接",
    "user": {
      "name": "UP主名称",
      "avatar": "UP主头像URL"
    },
    "videos": [
      {
        "title": "视频标题",
        "duration": 视频时长（秒）,
        "durationFormat": "04:45:58",
        "url": "视频下载链接",
        "index": 1
      }
    ],
    "totalVideos": 2
  }
}

2. get_bilibili_video_info

获取 Bilibili 视频的详细信息。

参数：

url (必填): Bilibili 视频链接

示例：

获取这个视频的详细信息：https://b23.tv/XhtfoyZ

3. get_bilibili_download_urls

获取 Bilibili 视频的下载链接列表。

参数：

url (必填): Bilibili 视频链接

示例：

获取这个视频的下载链接：https://b23.tv/XhtfoyZ

4. get_bilibili_basic_info

获取 Bilibili 视频的基本信息。

参数：

url (必填): Bilibili 视频链接

示例：

获取这个视频的基本信息：https://b23.tv/XhtfoyZ

5. get_bilibili_collection

获取 Bilibili 合集中的所有视频列表信息。

参数：

url (必填): Bilibili 视频链接（合集链接）

示例：

获取这个合集的所有视频：https://b23.tv/XhtfoyZ

使用示例

示例 1：解析单个视频

用户输入：

帮我解析这个 Bilibili 视频：https://b23.tv/XhtfoyZ

Claude 会自动调用：

parse_bilibili_video 工具

返回结果： 视频的完整信息，包括标题、封面、下载链接、UP主信息等。

示例 2：获取下载链接

用户输入：

获取这个视频的下载链接：https://b23.tv/XhtfoyZ

Claude 会自动调用：

get_bilibili_download_urls 工具

返回结果： 视频下载链接列表，包括合集中的所有视频。

示例 3：查看合集视频

用户输入：

这个合集有哪些视频？https://b23.tv/XhtfoyZ

Claude 会自动调用：

get_bilibili_collection 工具

返回结果： 合集中的所有视频列表，包括每个视频的标题和时长。

测试

使用 MCP Inspector 测试工具：

npm run inspector

这会启动一个交互式测试界面，您可以测试所有可用的工具。

开发

项目结构

bilibili-mcp/
├── src/
│   ├── BilibiliApi.ts    # Bilibili API 封装层
│   └── index.ts          # MCP 服务器主入口
├── build/                # 编译输出目录
├── package.json          # 项目配置
├── tsconfig.json         # TypeScript 配置
└── README.md            # 项目说明