使用说明
项目简介
本项目 'Bilibili-Mcp-Server' 是一个基于 FastMCP 框架构建的 MCP (Model Context Protocol) 服务器,专注于提供B站 (Bilibili) 平台的相关数据和操作接口。通过该服务器,LLM 应用可以便捷地获取B站的视频信息、用户信息、排行榜数据以及用户收藏夹内容,并进行点赞、关注等互动操作,从而扩展 LLM 在内容理解和用户交互方面的能力。
主要功能点
- 视频信息获取: 获取B站视频的标题、描述、上传时间等基本信息。
- 视频互动: 支持对B站视频进行点赞操作。
- 用户信息获取: 获取B站用户的用户名、头像等基本信息,以及用户硬币数量。
- 用户关系: 支持关注B站用户。
- 排行榜数据: 获取B站排行榜数据。
- 用户收藏夹: 获取用户B站收藏夹中的视频内容。
安装步骤
- 安装 uv: 确保你的环境中已安装 uv 包管理器。如果未安装,请参考 uv 安装文档 进行安装。
- 安装依赖: 在项目根目录下,使用 uv 安装项目依赖。
uv install - 配置环境变量: 复制 '.env' 文件模板并重命名为 '.env',根据 B站API文档 指引,获取 'SESSDATA', 'BILI_JCT', 'DEDEUSERID' 等 B站 API 访问所需的 Cookie 信息,并填写到 '.env' 文件中。
SESSDATA=your_sessdata BILI_JCT=your_bili_jct DEDEUSERID=your_deuserid
服务器配置
以下 JSON 配置信息用于 MCP 客户端连接 'Bilibili-Mcp-Server'。你需要将此配置添加到你的 MCP 客户端 (如 FastMCP Inspector) 的服务器列表中。
{ "bilibili-mcp-server": { // 服务器名称,在客户端中用于标识 "disabled": false, // 是否禁用该服务器,false 表示启用 "timeout": 60, // 请求超时时间,单位秒 "command": "uv", // 启动服务器的命令,这里使用 uv 运行 Python 脚本 "args": [ // 启动命令的参数列表 "run", // uv 的 run 命令,用于运行 Python 脚本 "server.py" // 服务器主脚本文件 ], "env": { // 环境变量配置 "SESSDATA": "your sessdata", // B站 SESSDATA Cookie,请替换为你的 Cookie "BILI_JCT": "your bili_jct", // B站 BILI_JCT Cookie,请替换为你的 Cookie "DEDEUSERID": "your deuserid" // B站 DEDEUSERID Cookie,请替换为你的 UID }, "transportType": "stdio" // 使用标准输入输出流进行通信 } }
注意:
- 请务必替换 'env' 中的 'your sessdata', 'your bili_jct', 'your deuserid' 为你自己的 B站 Cookie 信息。
- 'command' 和 'args' 配置指定了服务器的启动方式,这里配置为使用 'uv run server.py' 运行服务器。请确保你的环境中 'uv' 命令可用,并且项目依赖已正确安装。
- 'transportType' 设置为 'stdio',表示 MCP 客户端将通过标准输入输出流与服务器进行通信。
基本使用方法
- 启动 MCP 服务器:在项目根目录下,使用 MCP 客户端 (如 FastMCP Inspector) 加载上述服务器配置,并启动 'Bilibili-Mcp-Server'。
- 使用 MCP 客户端调用工具:在 MCP 客户端中,你可以找到注册到 'Bilibili-Mcp-Server' 的各种工具 (Tools),例如 'get_video_info', 'like_video', 'get_user_info' 等。根据工具的参数要求,填写参数值,即可调用相应的 B站 API 功能。
- 查看结果:工具执行结果将以 JSON-RPC 响应的形式返回到 MCP 客户端,你可以在客户端中查看和使用这些数据。
例如,你可以调用 'get_video_info' 工具并传入 B站视频 BV 号 (bvid),即可获取该视频的详细信息。
信息
分类
网页与API