B站 API 服务

解决什么问题

在把 Bilibili 数据接入大模型或 Agent 时，常见痛点是接口分散、鉴权口径不统一，以及把网络请求和业务逻辑混在一起。这个 MCP 服务器把 bilibili.com 相关能力收敛为三个工具：scripts.tools.get_user_info、scripts.tools.get_video_info 和 scripts.tools.search_videos。模型不需要理解 HTTP 细节，只需要按用户意图选择工具、补齐参数，并把返回的 JSON 整理后展示。

核心能力

它提供三层能力：用户信息查询、视频详情查询、视频搜索。用户信息通过 mid 定位；视频详情通过 bvid 定位；视频搜索通过 keyword，可选 page 默认 1，count 默认 10，最大 20。工作方式被拆成固定路由：先检查 API 密钥，再选择工具，再提取参数，最后以关键字参数调用 scripts.tools。例如搜索可表达为 scripts.tools.search_videos(keyword='Vue 3 教程', page=1, count=10)。返回结构统一为 result['raw']、result['success']、result['message']，调用方只需判断成功与否并处理 raw。

关键流程

1. 鉴权：从配置读取密钥；若 scripts.config.settings.api_key 为空，必须向用户询问，再用 scripts.config.set_api_key(key) 保存。密钥申请入口见 https://xiaobenyang.com。
2. 路由：模型根据意图映射到用户信息、视频详情或搜索。
3. 参数校验：缺少必填参数时先追问，不猜默认值。
4. 执行与返回：代码负责 API 调用，模型负责整理展示。

适用边界

它不是爬虫或公开数据代理，而是依赖 API 密钥的 MCP 服务。没有密钥时不能自行搜索或编造数据；搜索数量上限为 20，分页语义取决于接口返回；涉及账号隐私或版权内容时，仍需遵守上游平台的授权与限制。