Bilibii MCP Server

🚀 Bilibili Follower Count Query MCP Service

This is a service based on the Model Context Protocol (MCP) for querying the follower count of Bilibili users. By providing a Bilibili user ID, you can obtain the user's follower count.

🚀 Quick Start

Prerequisites

• Node.js v16.0.0 or higher
• npm or yarn package manager

Installation Steps

1. Clone or download this repository.
2. Navigate to the project directory and install dependencies.

cd bilibili-mcp-server
npm install

Starting the Server

npm start

After successful startup, the terminal will display:

Starting Bilibili Follower Count MCP Service...
MCP Service is connected and running!
Use Inspector to access the getBilibiliFollowerCount tool

Testing with MCP Inspector

1. Install MCP Inspector (if not already installed).
2. Connect the Inspector to the local MCP server.
3. Select the getBilibiliFollowerCount tool.
4. Enter the parameters:
   • userId: The numeric ID of the Bilibili user (e.g., 184594996, 163637592, etc.).
5. Click "Run" to execute the query.

Output Format

Successful response:

{
  "result": {
    "username": "Username",
    "followerCount": 12345
  }
}

Error response:

{
  "error": "Error message"
}

✨ Features

• Directly query the follower count of Bilibili users by user ID.
• Support the MCP protocol, enabling integration with large models such as Claude and GPT.
• Support error handling and detailed logging.

📦 Installation

Prerequisites

• Node.js v16.0.0 or higher
• npm or yarn package manager

Installation Steps

1. Clone or download this repository.
2. Navigate to the project directory and install dependencies.

cd bilibili-mcp-server
npm install

💻 Usage Examples

Basic Usage

# Start the server
npm start

Advanced Usage

# Test the Bilibili API directly using the test script
node test-api.js

📚 Documentation

How to Obtain a Bilibili User ID

You can obtain a Bilibili user ID in the following ways:

1. Visit the user's space page and check the URL.
   • For example, in https://space.bilibili.com/163637592, 163637592 is the user ID.
2. Search for the username on Bilibili, click into the user's space, and check the numeric ID in the URL.

Frequently Asked Questions

Q: Why use a user ID instead of a username?

A: The Bilibili API directly supports querying by user ID, which is more reliable and efficient. Usernames may be duplicated or changed, while IDs are unique.

Q: How to handle API request failures?

A: The service will automatically retry and record detailed error logs. You can view the error details in the logs directory.

🔧 Technical Details

API Reference

getBilibiliFollowerCount

Get the follower count of a Bilibili user.

Parameters:

• userId (required): The Bilibili user ID, a pure number, usually 7 - 10 digits, such as "163637592".

Return Values:

• username: The username.
• followerCount: The follower count.

📄 License

MIT