🚀 B站粉丝数查询 MCP 服务
这是一个基于模型上下文协议（MCP）的服务，可用于查询B站用户的粉丝数量。只需提供B站用户ID，就能轻松获取该用户的粉丝数。
🚀 快速开始
本服务能让你通过简单的操作查询B站用户粉丝数。你只需按照以下步骤，就能快速使用该服务。
✨ 主要特性
- 🆔 通过用户ID直接查询B站用户粉丝数，方便快捷。
- 🤝 支持MCP协议，可与Claude、GPT等大模型集成，拓展应用场景。
- 🛠️ 支持错误处理和详细日志记录，便于排查问题。
📦 安装指南
前置要求
- Node.js v16.0.0 或更高版本
- npm 或 yarn 包管理器
安装步骤
- 克隆或下载本仓库。
- 进入项目目录并安装依赖。
cd bilibili-mcp-server
npm install
💻 使用示例
基础用法
启动服务器
npm start
启动成功后，终端会显示：
Starting Bilibili 粉丝数 MCP 服务...
MCP 服务已连接并运行！
Use Inspector 访问 getBilibiliFollowerCount 工具
使用MCP Inspector测试
- 安装MCP Inspector（如果尚未安装）。
- 将Inspector连接到本地MCP服务器。
- 选择
getBilibiliFollowerCount工具。 - 输入参数：
userId: B站用户的数字ID (如：184594996，163637592等)
- 点击"Run"执行查询。
输出格式
成功响应:
{
"result": {
"username": "用户名",
"followerCount": 12345
}
}
错误响应:
{
"error": "错误信息"
}
📚 详细文档
API参考
getBilibiliFollowerCount
获取B站用户的粉丝数量。
参数:
userId(必填): B站用户ID，纯数字，通常为7 - 10位，如"163637592"
返回值:
username: 用户名followerCount: 粉丝数量
如何获取B站用户ID
B站用户ID可以通过以下方式获取：
- 访问用户空间页面，查看URL。
- 例如：https://space.bilibili.com/163637592 中的 163637592 即为用户ID。
- 在B站搜索用户名，点击进入用户空间，查看URL中的数字ID。
常见问题
Q: 为什么需要使用用户ID而不是用户名?
A: B站API直接支持通过用户ID查询，这种方式更加可靠和高效。用户名可能重复或变更，而ID是唯一的。
Q: 如何处理API请求失败?
A: 服务会自动重试并记录详细错误日志，您可以在logs目录中查看错误详情。
测试工具
项目包含一个测试脚本，用于直接测试B站API:
node test-api.js
这将测试几个预设的用户ID，并显示详细的响应结果。
📄 许可证
本项目采用MIT许可证。