使用说明

项目简介

本项目 'Bilibili-Mcp-Server' 是一个基于 FastMCP 框架构建的 MCP (Model Context Protocol) 服务器,专注于提供B站 (Bilibili) 平台的相关数据和操作接口。通过该服务器,LLM 应用可以便捷地获取B站的视频信息、用户信息、排行榜数据以及用户收藏夹内容,并进行点赞、关注等互动操作,从而扩展 LLM 在内容理解和用户交互方面的能力。

主要功能点

  • 视频信息获取: 获取B站视频的标题、描述、上传时间等基本信息。
  • 视频互动: 支持对B站视频进行点赞操作。
  • 用户信息获取: 获取B站用户的用户名、头像等基本信息,以及用户硬币数量。
  • 用户关系: 支持关注B站用户。
  • 排行榜数据: 获取B站排行榜数据。
  • 用户收藏夹: 获取用户B站收藏夹中的视频内容。

安装步骤

  1. 安装 uv: 确保你的环境中已安装 uv 包管理器。如果未安装,请参考 uv 安装文档 进行安装。
  2. 安装依赖: 在项目根目录下,使用 uv 安装项目依赖。
    uv install
  3. 配置环境变量: 复制 '.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 客户端将通过标准输入输出流与服务器进行通信。

基本使用方法

  1. 启动 MCP 服务器:在项目根目录下,使用 MCP 客户端 (如 FastMCP Inspector) 加载上述服务器配置,并启动 'Bilibili-Mcp-Server'。
  2. 使用 MCP 客户端调用工具:在 MCP 客户端中,你可以找到注册到 'Bilibili-Mcp-Server' 的各种工具 (Tools),例如 'get_video_info', 'like_video', 'get_user_info' 等。根据工具的参数要求,填写参数值,即可调用相应的 B站 API 功能。
  3. 查看结果:工具执行结果将以 JSON-RPC 响应的形式返回到 MCP 客户端,你可以在客户端中查看和使用这些数据。

例如,你可以调用 'get_video_info' 工具并传入 B站视频 BV 号 (bvid),即可获取该视频的详细信息。

信息

分类

网页与API