Bilibili MCP

1下面是为你的 `bilibili-mcp` 工具生成的 `README.md` 示例：
2 
3---
4 
5# 📺 bilibili-mcp
6 
7一个用于获取 B 站热榜的 MCP 工具，基于 FastMCP 和 B 站公开接口。你可以通过注册到 Cursor 或其他 MCP 客户端，实时调用热门视频数据。
8 
9## 🚀 快速开始
10 
11### 1. 安装依赖
12 
13确保使用 Python ≥ 3.12，并安装以下依赖项：
14 
15```bash
16pip install httpx "mcp[cli]>=1.6.0"
17```
18 
19### 2. 项目结构示例
20 
21你的主代码文件可以是 `bilibili_mcp.py`，项目结构如下：
22 
23```
24bilibili_mcp/
25├── bilibili_mcp.py
26├── pyproject.toml
27└── README.md
28```
29 
30### 3. 启动 MCP Server
31 
32使用 [`uv`](https://github.com/astral-sh/uv) 运行工具：
33 
34```bash
35uv tool run bilibili-mcp
36```
37 
38或通过配置文件引用：
39 
40```jsonc
41"bilibili-j": {
42  "command": "uv",
43  "args": [
44    "tool",
45    "run",
46    "bilibili-mcp"
47  ]
48}
49```
50 
51### 4. 注册工具
52 
53FastMCP 会自动暴露一个名为 `get_popular` 的工具：
54 
55#### 📦 `get_popular(top_k: int = 3)`
56 
57获取 B 站热榜视频信息，返回最多 `top_k` 个条目（最大 10 条）。
58 
59##### 返回示例：
60 
61```json
62[
63  {
64    "title": "“战火啊，能不能在黎明前停歇一次”",
65    "link": "https://b23.tv/BV1...z",
66    "desc": "喜欢的朋友可以点赞投币关注一下哦，你的支持是我最大的动力！！",
67    "view": 1234567,
68    "like": 98765
69  },
70  ...
71]
72```
73 
74## 🛠 技术说明
75 
76- 使用 `httpx` 实现异步请求
77- 通过 FastMCP 注册为标准 MCP 工具
78- 支持通过 `stdio` 与 MCP 客户端通信（例如 Cursor）
79 
80## 📌 注意事项
81 
82- 仅用于学习与研究，B 站接口为公开接口，使用时请避免过于频繁访问。
83- 默认 `User-Agent` 为 `"qwq"`，可根据实际情况更改为更合理的字符串。
84 
85## 📄 License
86 
87MIT License.