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许可证。