# Bilibili MCP Server

> Bilibili MCP Server is an MCP server for design and media. Read Bilibili subtitles, comments, creators and favourites from your AI agent. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI
- **Repository:** https://github.com/xzxzzx-ai/bilibili-mcp
- **MCP Registry name:** io.github.XZXZZX-Ai/bilibili-mcp
- **Categories:** [design and media](https://ai-powered.com/categories/design-and-media)
- **Listing updated:** 2026-11-15

## About

A local server that reads Bilibili for an agent. It fetches full subtitles or searches them by keyword, returning each hit with context, a timestamp and a link that jumps to that moment. It also reads comments ranked by popularity or time, video metadata, multi-part structure and chapters.

Beyond single videos, an agent can search videos by topic, search for creators, summarise a creator's profile, videos, collections, series and posts, and page through the logged-in account's favourite folders. For videos with no subtitles, an optional local speech-to-text model (faster-whisper in three sizes, about 78 to 486 MB) can transcribe one part on request. Native subtitles come first, and AI-generated subtitles are labelled so they are not mistaken for human ones.

It needs Node 20 or newer and credentials set up in a local terminal by QR code or manual cookie, never pasted into chat. Cookies go only to Bilibili's official endpoints.

## Features

- **Subtitle search:** Keyword hits with context and jump-to-moment links.
- **Comment reading:** Sort by popularity or time, including replies.
- **Creator exploration:** Profile, videos, collections, series and posts.
- **Favourites browsing:** Page through your own favourite folders.
- **Local transcription:** Optional on-device ASR for videos without subtitles.
- **AI subtitle labelling:** Marks AI-generated subtitles and can exclude them.

## Good for

- Quote the exact moment a Bilibili video says something
- Summarise a creator's main topics
- Check what viewers say in comments
- Transcribe a video that has no subtitles

## Install

### Claude Code (Terminal)

```sh
claude mcp add bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "bilibili-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@xzxzzx/bilibili-mcp"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "bilibili-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@xzxzzx/bilibili-mcp"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "bilibili-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@xzxzzx/bilibili-mcp"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "bilibili-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@xzxzzx/bilibili-mcp"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "bilibili-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@xzxzzx/bilibili-mcp"
      ]
    }
  }
}
```

## Tools

- `search_bilibili_videos`: Searches Bilibili by topic and returns candidates with title, creator, length and BVID.
- `search_bilibili_creators`: Finds creator candidates by name or keyword.
- `get_bilibili_creator_content`: Reads a creator's overview, videos, collections, series or posts.
- `list_bilibili_favorite_videos`: Pages through the account's favourite folders.
- `get_video_info`: Returns subtitle-first video context.
- `get_video_transcript`: Returns the full transcript, keyword hits, or local ASR for videos without subtitles.
- `get_video_metadata`: Returns title, creator, views and other structured data.
- `get_video_comments`: Returns comments and replies.
- `check_bilibili_credentials`: Reports whether credentials are configured and logged in.

## FAQ

### What does setup need?

Node 20 or newer, then a local setup step for credentials by QR code or cookie.

### Is speech recognition required?

No, the local ASR model is optional and off by default.

### Are credentials shared with the agent?

No, they are entered in a local terminal, not in chat.

### How do I add Bilibili MCP Server to Claude Code?

Run this command in your terminal: claude mcp add bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp

### What are the best alternatives to Bilibili MCP Server?

The closest alternatives to Bilibili MCP Server are VideoDataAPI — Video Transcript, Captions, Search & Comments MCP Server, GeekLink Subtitle MCP (Developer Preview), Bilibili Huasheng Video, YTAPI and BPJ Video Tools.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [VideoDataAPI — Video Transcript, Captions, Search & Comments MCP Server](https://ai-powered.com/mcp/videodataapi-video-transcript-captions-search-and-comments-m): VideoDataAPI — Video Transcript, Captions, Search & Comments MCP Server is a freemium MCP server for design and media.
- [GeekLink Subtitle MCP (Developer Preview)](https://ai-powered.com/mcp/geeklink-subtitle-mcp-developer-preview): GeekLink Subtitle MCP (Developer Preview) is an MCP server for design and media.
- [Bilibili Huasheng Video](https://ai-powered.com/mcp/bilibili-huasheng-video): Bilibili Huasheng Video is an MCP server for design and media.
- [YTAPI](https://ai-powered.com/mcp/ytapi): YTAPI is an MCP server for design and media.
- [BPJ Video Tools](https://ai-powered.com/mcp/bpj-video-tools): BPJ Video Tools is a free MCP server for design and media.
- [CantoneseTTS.com: Hong Kong Cantonese Voiceover & SRT MCP](https://ai-powered.com/mcp/cantonesetts-com-hong-kong-cantonese-voiceover-and-srt-mcp): CantoneseTTS.com: Hong Kong Cantonese Voiceover & SRT MCP is a paid MCP server for design and media.
- [Guruling: ask a YouTube channel](https://ai-powered.com/mcp/guruling-ask-a-youtube-channel): Guruling: ask a YouTube channel is a free MCP server for design and media.
- [yt-dlp MCP](https://ai-powered.com/mcp/yt-dlp-mcp): yt-dlp MCP is an open-source MCP server for design and media.

---
Source: https://ai-powered.com/mcp/bilibili-mcp-server
