Skip to main content
Glama

bilibili-mcp

A content-intelligence bridge for Bilibili (B站), China's largest video platform. Search, trending, video intel and transcript summarisation - no account needed for the core tier.

What this wraps

Bilibili - the Chinese video sharing platform. This server does not play video; it returns metadata, lists and subtitle transcripts so an agent can search, rank and summarise Bilibili content. See docs/WRAPPEE.md.

Related MCP server: Bilibili API MCP Server

Preview

Dashboard

What You Can Do

How it runs

Mode

Host app

When

Headless / API (default)

Bilibili public web APIs

Everything - no account, no GUI

Bilibili is a web platform, not a local app - there is no desktop binary to install. The server talks to Bilibili's public API over HTTPS.

Hands-in / Hands-out

Direction

Artifacts

Notes

Hands-in

search keyword, Bilibili URL (BV.../av...)

bilibili_search, bilibili_video

Hands-out

metadata + stats, transcript text, comment summaries

bilibili_video, bilibili_transcript

Capabilities

  • Explore - popular feed, all-region ranking, hot search keywords (anonymous)

  • Search - videos and creators (may need a cookie to pass risk control)

  • Video intel - metadata + stats, part list, hot comments (anonymous)

  • Transcript - auto-subtitle text for summarisation (the killer feature)

  • Account tier (optional) - following feed, favorites; needs a +86 login

Anonymous by default - explore, video intel and transcripts work with zero setup. Only the account tier needs a Chinese +86 login cookie.

Quick Install

Requirements: uv (Python), Bun (webapp). Option A (recommended):

uv sync
uv run python -m bilibili_mcp.server --mode http --port 11185

Or run the full stack (backend + webapp + browser) with start.bat / start.ps1. Backend 11185, frontend 11186.

First time? Complete docs/ONBOARDING.md before expecting live host calls (anonymous tier needs nothing; account tier needs a +86 login).

Documentation

Doc

What it covers

Onboarding

Accounts, the +86 number question, first-run setup

Configuration

Env vars, tiers, LLM provider

Tools

Full MCP + REST reference

Development

Layout, running, testing

Troubleshooting

Symptom -> fix

Wrappee

About the Bilibili platform

SPEC

Feature spec + stage plan

Tier status

Tier

Requires

Unlocks

Anonymous

nothing

explore, search, video intel, transcript

Account

BILIBILI_COOKIE (+86 login)

following feed, favorites

License

MIT

Available Tools

10 tools
bilibili_accountA

Account-tier operations: tier status, following feed, favorites.

[RATIONALE] The account tier is one logical surface (your logged-in Bilibili world) with several sub-surfaces; one tool with an operation discriminator keeps it compact while the auth-gated ops are honestly marked requires_login.

Return Format

{"success": bool, "operation": str, "data": {...}, "message": str}

Examples

bilibili_account(operation="status") bilibili_account(operation="following") bilibili_account(operation="favorites")

Inputs: operation (required), mid. Returns: data, error, message, success, +3 more

bilibili_exploreA

Discover what is trending on Bilibili: popular feed, rankings, hot keywords.

[RATIONALE] Discovery has three list surfaces (popular, rank, hot search) that share a single 'video-ish list' output; one tool with an operation discriminator keeps the surface compact and discoverable.

Return Format

{"success": bool, "operation": str, "data": [...], "count": int}

Examples

bilibili_explore(operation="trending", limit=10) bilibili_explore(operation="rank", rid=3, limit=15) bilibili_explore(operation="hot_search", limit=10)

Inputs: operation (required), rid, limit. Returns: data, count, error, message, +4 more

bilibili_helpA

Explain how to use the bilibili-mcp server.

Return Format

{"success": bool, "data": {"help": str, "tools": [...]}, "message": str}

Examples

bilibili_help() bilibili_help(topic="transcript")

Inputs: topic. Returns: object

bilibili_shutdownA

Gracefully stop the bilibili-mcp server.

Return Format

{"success": bool, "message": str}

Examples

bilibili_shutdown(confirm=True)

Inputs: confirm. Returns: object

bilibili_transcriptA

Fetch a video's auto-generated subtitle track as plain text.

Returns the transcript as text so an LLM can summarise or translate it. Some videos have no subtitles (or subtitles require login to access); in that case the tool returns an honest, actionable error rather than empty.

Return Format

{"success": bool, "data": {"bvid": str, "cid": int, "lang": str, "text": str, "word_count": int}, "message": str}

Examples

bilibili_transcript(bvid="BV1xx411c7mD") bilibili_transcript(bvid="https://www.bilibili.com/video/BV1xx411c7mD", part_index=2)

Inputs: bvid (required), part_index. Returns: data, error, message, success, +2 more

bilibili_videoA

Inspect a single Bilibili video: metadata, comments, or part list.

Return Format

{"success": bool, "operation": str, "data": {...}, "message": str}

Examples

bilibili_video(operation="info", bvid="BV1xx411c7mD") bilibili_video(operation="comments", bvid="BV1xx411c7mD", limit=10) bilibili_video(operation="pages", bvid="BV1xx411c7mD")

Inputs: operation (required), aid, bvid, limit. Returns: data, error, message, success, +3 more

show_bilibili_cache_cardB

Show and clear the Bilibili response cache.

[RATIONALE] A tiny status surface for the TTL cache - helps debug rate-limit staleness.

Return Format

ToolResult with content + structured PrefabApp card.

Examples

show_bilibili_cache_card()

Inputs: no named parameters.

show_bilibili_status_cardA

Show bilibili-mcp configuration status as a rich in-chat card.

[RATIONALE] Status tools MUST ship a Prefab surface - one call shows tier, cookie state and cache headroom at a glance.

Return Format

ToolResult with content (plain text fallback) + structured PrefabApp card.

Examples

show_bilibili_status_card()

Inputs: no named parameters.

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 10 tools

    Disambiguation4/5

    Core tools cleanly separate account, explore, search, transcript, and video resources. Minor overlap exists between bilibili_explore(trending) and show_bilibili_trending_card, and bilibili_account(operation='status') could be confused with show_bilibili_status_card, but the descriptions make the distinction recoverable.

    Naming Consistency4/5

    All tools use a bilibili_ prefix or show_bilibili_*_card pattern, so the two naming families are internally consistent. The mix of noun-style names like bilibili_account and verb-style names like bilibili_search is a minor deviation but still predictable and readable.

    Tool Count5/5

    Ten tools is well-scoped for a Bilibili-oriented server covering discovery, search, video inspection, transcripts, account data, and system status. The card tools add some redundancy but each has a distinct presentation purpose.

    Completeness4/5

    The read/inspect/search/transcribe workflow is well covered: videos, comments, pages, transcript, search, trending, rankings, hot search, account following, and favorites. Minor gaps include no user profile detail, no comment thread replies, and no authenticated actions beyond reading.

    Related MCP Connectors

    Related MCP Servers

    • F
      license
      Not graded
      quality
      D
      maintenance
      Enables interaction with Bilibili (哔哩哔哩) through its API, supporting video search and recommendations, user search, dynamic feeds, video collections, and danmaku retrieval through natural language.
      5
      -
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables models to look up Bilibili's trending videos, keyword search results, video details, and popular danmaku, returning compact plain-text summaries instead of bulky JSON. Works without login, cookies, or extra dependencies, and also runs standalone from the command line.
      MIT