Bilibii MCP Server

🚀 B站粉絲數查詢 MCP 服務

這是一個基於模型上下文協議（MCP）的服務，可用於查詢B站用戶的粉絲數量。只需提供B站用戶ID，就能輕鬆獲取該用戶的粉絲數。

🚀 快速開始

本服務能讓你通過簡單的操作查詢B站用戶粉絲數。你只需按照以下步驟，就能快速使用該服務。

✨ 主要特性

• 🆔 通過用戶ID直接查詢B站用戶粉絲數，方便快捷。
• 🤝 支持MCP協議，可與Claude、GPT等大模型集成，拓展應用場景。
• 🛠️ 支持錯誤處理和詳細日誌記錄，便於排查問題。

📦 安裝指南

前置要求

• Node.js v16.0.0 或更高版本
• npm 或 yarn 包管理器

安裝步驟

1. 克隆或下載本倉庫。
2. 進入項目目錄並安裝依賴。

cd bilibili-mcp-server
npm install

💻 使用示例

基礎用法

啟動服務器

npm start

啟動成功後，終端會顯示：

Starting Bilibili 粉絲數 MCP 服務...
MCP 服務已連接並運行！
Use Inspector 訪問 getBilibiliFollowerCount 工具

使用MCP Inspector測試

1. 安裝MCP Inspector（如果尚未安裝）。
2. 將Inspector連接到本地MCP服務器。
3. 選擇getBilibiliFollowerCount工具。
4. 輸入參數：
   • userId: B站用戶的數字ID (如：184594996，163637592等)
5. 點擊"Run"執行查詢。

輸出格式

成功響應:

{
  "result": {
    "username": "用戶名",
    "followerCount": 12345
  }
}

錯誤響應:

{
  "error": "錯誤信息"
}

📚 詳細文檔

API參考

getBilibiliFollowerCount

獲取B站用戶的粉絲數量。

參數:

• userId (必填): B站用戶ID，純數字，通常為7 - 10位，如"163637592"

返回值:

• username: 用戶名
• followerCount: 粉絲數量

如何獲取B站用戶ID

B站用戶ID可以通過以下方式獲取：

1. 訪問用戶空間頁面，查看URL。
   • 例如：https://space.bilibili.com/163637592 中的 163637592 即為用戶ID。
2. 在B站搜索用戶名，點擊進入用戶空間，查看URL中的數字ID。

常見問題

Q: 為什麼需要使用用戶ID而不是用戶名?

A: B站API直接支持通過用戶ID查詢，這種方式更加可靠和高效。用戶名可能重複或變更，而ID是唯一的。

Q: 如何處理API請求失敗?

A: 服務會自動重試並記錄詳細錯誤日誌，您可以在logs目錄中查看錯誤詳情。

測試工具

項目包含一個測試腳本，用於直接測試B站API:

node test-api.js

這將測試幾個預設的用戶ID，並顯示詳細的響應結果。

📄 許可證

本項目採用MIT許可證。