Skip to main content
Glama
sunwu51

bilibili-info-mcp

by sunwu51

bilibili-info-mcp

npm version GitHub

MCP server for fetching Bilibili video metadata and subtitles. Runs locally via stdio transport.

Features

  • Fetch video metadata: title, author, view count, description, duration, publish date

  • Fetch subtitles (requires login cookie): prioritizes Chinese, falls back to English

  • WBI signature support for reliable subtitle retrieval

  • Stdio transport for local MCP client integration

Related MCP server: transcriptor-mcp

Usage

No installation required. Use directly with npx:

npx bilibili-info-mcp

MCP Client Configuration

Cursor / Claude Desktop

{
  "mcpServers": {
    "bilibili-info": {
      "command": "npx",
      "args": ["bilibili-info-mcp"],
      "env": {
        "SESSDATA": "your_bilibili_sessdata_cookie"
      }
    }
  }
}

Environment Variables

Variable

Required

Description

SESSDATA

Only for subtitles

Bilibili login cookie. Find it in browser DevTools > Application > Cookies > bilibili.com after logging in.

Tool: get-bilibili-video-info

Fetches Bilibili video metadata and optionally subtitles.

Input

Parameter

Type

Required

Default

Description

url

string

Yes

-

Bilibili video URL, e.g. https://www.bilibili.com/video/BVxxxxx

includeSubtitles

boolean

No

false

Whether to fetch subtitles. Requires SESSDATA env var.

Supported URL formats:

  • https://www.bilibili.com/video/BVxxxxx

  • https://m.bilibili.com/video/BVxxxxx?k=v

  • https://bilibili.com/video/BVxxxxx/

Output

{
  "title": "Video title",
  "author": "Author name",
  "viewCount": "12345",
  "description": "Video description",
  "lengthSeconds": "360",
  "publishDate": "2025-01-15T12:00:00+08:00",
  "subtitle": {
    "languageCode": "zh-Hans",
    "content": "Subtitle text content joined by spaces"
  }
}

Field

Type

Description

title

string

Video title

author

string

Uploader name

viewCount

string

Total view count

description

string

Video description (prefers desc_v2, falls back to desc)

lengthSeconds

string

Video duration in seconds

publishDate

string

Publish time in ISO 8601 format with +08:00 timezone

subtitle

object (optional)

Subtitle track, only present when includeSubtitles is true and subtitles are available

Subtitle Priority

When includeSubtitles is true, returns a single subtitle track with the following priority:

  1. Chinese (matching 中文, zh-CN, zh-Hans, zh)

  2. English (matching English, 英语, en, en-US)

Development

git clone https://github.com/sunwu51/bilibili-info-mcp.git
cd bilibili-info-mcp
npm install
npm run build

Project Structure

src/
  index.ts              # MCP server entry point (stdio transport)
  bilibili-fetcher.ts   # Bilibili API calls (video info + subtitles)
  wbi.ts                # WBI signature algorithm implementation

How It Works

  1. Video info -- Calls https://api.bilibili.com/x/web-interface/view?bvid=BVID to get metadata.

  2. WBI keys -- Fetches img_key and sub_key from https://api.bilibili.com/x/web-interface/nav (cached for 1 hour).

  3. Subtitles -- Calls https://api.bilibili.com/x/player/wbi/v2 with WBI signature (w_rid + wts) and SESSDATA cookie to get subtitle URLs, then fetches the subtitle JSON content.

License

ISC

Available Tools

1 tool
get-bilibili-video-infoA

Fetches Bilibili video metadata (title, author, duration, description, publish date, view count) and subtitles/captions.

ParametersJSON Schema
NameRequiredDescriptionDefault
urlYesBilibili video URL, e.g. https://www.bilibili.com/video/BVxxxxx
includeSubtitlesNoWhether to include subtitles/captions in the response. Requires SESSDATA environment variable to be set.

Output Schema

ParametersJSON Schema
NameRequiredDescription
titleYes
authorYes
subtitleNo
viewCountYes
descriptionYes
publishDateYes
lengthSecondsYes

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so the description carries the burden of behavioral disclosure. 'Fetches' appropriately signals a read-only operation, but the phrasing 'and subtitles/captions' implies subtitles are always returned, whereas the schema shows includeSubtitles defaults to false and requires SESSDATA. The description does not mention authentication, rate limits, or that subtitle inclusion is optional, leaving some ambiguity.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single sentence with no filler, front-loading the main action and then expanding with a parenthetical field list. Every word contributes to the agent's understanding, and the structure is easy to parse.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple two-parameter metadata fetcher with an output schema present, the description plus schema covers the essentials. What is missing is an explicit qualifier that subtitles are optional and not returned by default; that detail lives only in the schema, so the description could mislead an agent that does not inspect parameter defaults closely.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already describes both parameters fully, including the url format example and the includeSubtitles default/requirement. The description adds no parameter-level detail beyond what the schema provides, so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb ('Fetches') and a specific resource ('Bilibili video metadata'), and enumerates the exact metadata fields it returns: title, author, duration, description, publish date, view count, plus subtitles/captions. There are no sibling tools to distinguish from, so this is as clear as needed.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description makes the tool's purpose clear, so an agent can infer when to use it: whenever Bilibili video metadata or subtitles are needed. It does not explicitly state exclusions or alternatives, but with no sibling tools, the lack of explicit when/not guidance is less critical.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev1.0.0
    • First observedget-bilibili-video-info

TDQS

A4/5.0

Scored across 1 tool

Disambiguation5/5

With only one tool, there is zero ambiguity or potential for misselection. The tool's purpose is fully unique by default.

Naming Consistency5/5

A single descriptive tool name using a get-<resource>-info pattern. Consistency is trivial but the style is clear and predictable.

Tool Count3/5

One tool feels thin for a video platform server, but it is compact and focused on the 'info' scope. It sits at the low end of the borderline range.

Completeness3/5

The tool covers metadata and subtitles for a known video, but there is no discovery (search/list/trending) or related operations (comments, chapters). This leaves an agent stranded without a video ID.

Maintenance

ActivityInactive
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    F
    maintenance
    An MCP server that enables users to search Bilibili videos, access trending rankings, and retrieve detailed information about videos, content creators, and anime schedules. It allows AI applications to interact directly with Bilibili content via simple API interfaces.
    47 npm
    192
    MIT
  • A
    license
    A
    quality
    A
    maintenance
    An MCP server (stdio + HTTP/SSE) that fetches video transcripts/subtitles via yt-dlp, with pagination for large responses. Supports YouTube, Twitter/X, Instagram, TikTok, Twitch, Vimeo, Facebook, Bilibili, VK, Dailymotion. Whisper fallback — transcribes audio when subtitles are unavailable (local or OpenAI API). Works with Cursor and other MCP host
    8
    21
    MIT
  • A
    license
    B
    quality
    D
    maintenance
    A Model Context Protocol (MCP) server that provides comprehensive video tools: transcript retrieval, video downloading, and automatic subtitle generation using AI speech-to-text. Works with YouTube, Bilibili, Vimeo, and any platform supported by yt-dlp.
    11
    MIT
  • A
    license
    Not graded
    quality
    C
    maintenance
    A Bilibili subtitle fetching MCP server that supports various input formats (BV number, video URL, short link) and offers configurable language preferences, output formats, and ASR fallback.
    8
    GPL 3.0