home / mcp / bilistalkermcp mcp server

BiliStalkerMCP MCP Server

Provides MCP access to Bilibili user data, video updates, dynamics, articles, and followings for AI assistants.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "222wcnm-bilistalkermcp": {
      "command": "uvx",
      "args": [
        "bili-stalker-mcp"
      ],
      "env": {
        "BUVID3": "your_buvid3",
        "BILI_JCT": "your_bili_jct",
        "SESSDATA": "your_sessdata",
        "BILI_LOG_LEVEL": "INFO"
      }
    }
  }
}

You deploy BiliStalkerMCP to provide a Model Context Protocol (MCP) interface for interacting with Bilibili data. This server enables AI assistants to access user profiles, video updates, dynamics, articles, and followings in a controlled way, making it practical to build chat-based tools and assistants that leverage Bilibili content while managing authentication and rate limits.

How to use

You run the MCP server locally or in your environment and connect your MCP client to it using the provided configuration. Once connected, you can query user information, fetch recent videos with subtitles, pull user dynamics, retrieve articles, and obtain the list of people a user follows. Use these capabilities to power AI-assisted analysis, summaries, or data-driven prompts.

How to install

Prerequisites: ensure you have Python and a compatible MCP client installed on your system.

Install the MCP server package using one of the following commands:

uvx bili-stalker-mcp
# or
pip install bili-stalker-mcp

Additional sections

Configuration and usage details are shown in the example that follows. You will configure your MCP client to connect to this server by providing the command and environment variables listed here.

Example MCP client configuration (inline JSON) to connect to the local server using the standard runtime command and environment values:

{
  "mcpServers": {
    "bilistalker": {
      "command": "uvx",
      "args": ["bili-stalker-mcp"],
      "env": {
        "SESSDATA": "your_sessdata",
        "BILI_JCT": "your_bili_jct",
        "BUVID3": "your_buvid3"
      }
    }
  }
}

Notes on environment variables: - SESSDATA is required and contains your Bilibili authentication token. - BILI_JCT is optional and provides CSRF protection. - BUVID3 helps reduce rate limiting by sharing a browser fingerprint. - BILI_LOG_LEVEL is optional and can be set to INFO, DEBUG, or WARNING (default is WARNING).

Available tools

get_user_info

Retrieves a user profile and basic statistics by user_id or username.

get_user_video_updates

Fetches recent videos posted by a user, including subtitles if available, with pagination support.

get_user_dynamic_updates

Obtains user dynamics with optional type filtering to narrow results.

get_user_articles

Retrieves articles published by a user with pagination.

get_user_followings

Returns the list of users followed by the specified user with pagination.