这是一款基于 FastMCP 和 B 站公开接口的 MCP 工具,其主要功能是获取 B 站热榜视频数据。用户可以将其注册到 Cursor 或其他 MCP 客户端,从而实时调用热门视频信息。
请确保你的 Python 版本 ≥3.12,然后安装以下依赖项:
pip install httpx "mcp[cli]>=1.6.0"
主代码文件可以命名为 bilibili_mcp.py
,项目结构如下:
bilibili_mcp/
├── bilibili_mcp.py
├── pyproject.toml
└── README.md
可以使用 uv
来运行工具:
uv tool run bilibili-mcp
也可以通过配置文件引用:
"bilibili-j": {
"command": "uv",
"args": [
"tool",
"run",
"bilibili-mcp"
]
}
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
实现异步请求。stdio
与 MCP 客户端(例如 Cursor)进行通信。本项目采用 MIT License。
⚠️ 重要提示
本工具仅用于学习和研究,B 站接口为公开接口,使用时请避免过于频繁访问。
💡 使用建议
默认
User-Agent
为"qwq"
,你可根据实际需求将其更改为更合理的字符串。