Bilibili MCP

🚀 嗶哩嗶哩熱門榜單工具（bilibili-mcp）

這是一款基於 FastMCP 和 B 站公開接口的 MCP 工具，其主要功能是獲取 B 站熱榜視頻數據。用戶可以將其註冊到 Cursor 或其他 MCP 客戶端，從而即時調用熱門視頻信息。

🚀 快速開始

1. 安裝依賴

請確保你的 Python 版本 ≥3.12，然後安裝以下依賴項：

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

2. 項目結構示例

主代碼文件可以命名為 bilibili_mcp.py，項目結構如下：

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

3. 啟動 MCP 服務

可以使用 uv 來運行工具：

uv tool run bilibili-mcp

也可以通過配置文件引用：

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

4. 註冊工具

FastMCP 會自動暴露一個名為 get_popular 的工具：

📦 get_popular(top_k: int = 3)

此工具用於獲取 B 站熱榜視頻信息，最多返回 top_k 個條目（上限為 10 條）。

返回示例：

[
  {
    "title": "“戰火啊，能不能在黎明前停歇一次”",
    "link": "https://b23.tv/BV1...z",
    "desc": "喜歡的朋友可以點贊投幣關注一下哦，你的支持是我最大的動力！！",
    "view": 1234567,
    "like": 98765
  },
  ...
]

🔧 技術細節

• 使用 httpx 實現異步請求。
• 基於 FastMCP 註冊為標準 MCP 工具。
• 支持通過 stdio 與 MCP 客戶端（例如 Cursor）進行通信。

📄 許可證

本項目採用 MIT License。

⚠️ 重要提示

本工具僅用於學習和研究，B 站接口為公開接口，使用時請避免過於頻繁訪問。

💡 使用建議

默認 User-Agent 為 "qwq"，你可根據實際需求將其更改為更合理的字符串。