Bilibili MCP

🚀 [Bilibili Popular List Tool (bilibili-mcp)]

This is an MCP tool based on FastMCP and Bilibili's public API, designed to fetch data of popular videos on Bilibili. You can register it to Cursor or other MCP clients to call the information of popular videos in real-time.

🚀 Quick Start

1. Install Dependencies

Make sure you are using Python version ≥3.12 and install the following dependencies:

pip install httpx "mcp[cli]>=1.6.0"

2. Project Structure Example

Your main code file can be bilibili_mcp.py, and the project structure is as follows:

bilibili_mcp/
├── bilibili_mcp.py
├── pyproject.toml
└── README.md

3. Start the MCP Service

Run the tool using uv:

uv tool run bilibili-mcp

Or reference it through a configuration file:

"bilibili-j": {
  "command": "uv",
  "args": [
    "tool",
    "run",
    "bilibili-mcp"
  ]
}

4. Register the Tool

FastMCP will automatically expose a tool named get_popular:

📦 get_popular(top_k: int = 3)

Get information about popular videos on Bilibili, returning at most top_k items (maximum of 10 items).

Example Return:

[
  {
    "title": "“战火啊，能不能在黎明前停歇一次”",
    "link": "https://b23.tv/BV1...z",
    "desc": "喜欢的朋友可以点赞投币关注一下哦，你的支持是我最大的动力！！",
    "view": 1234567,
    "like": 98765
  },
  ...
]

🔧 Technical Details

• Use httpx to implement asynchronous requests.
• Register as a standard MCP tool based on FastMCP.
• Support communication with MCP clients (e.g., Cursor) via stdio.

⚠️ Important Note

• This tool is only for learning and research purposes. The Bilibili API is public. Please avoid making overly frequent requests when using it.
• The default User-Agent is "qwq". You can change it to a more reasonable string according to your actual needs.

📄 License

MIT License.