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"，你可根据实际需求将其更改为更合理的字符串。