@xzxzzx/bilibili-mcp

v1.3.2

Published

3 days ago

Bilibili MCP tool for video and comment summarization

0High
0Medium
0Low

xzxzzx

mcp model-context-protocol bilibili video comments subtitle chinese b站视频总结评论总结

Bilibili MCP Tool

用claude code(glm4.7模型)做的总结B站视频的MCP(经过antigravity里的claude,gemini模型修改bug)(提取字幕与评论)

[!TIP] ⚠️ 提示：使用前请务必配置您的 B 站 Cookie，否则将无法提取视频字幕与评论。详见 ⚙️ 凭证配置(凭证只会保存在本地，不会上传到任何地方)。

View this document in English.

📑 目录

Bilibili MCP Tool

⚡ 快速预检

[!IMPORTANT] 本工具需要 Bilibili 凭证 (Cookie) 才能发挥完整功能。 如果没有正确配置凭证，您可能无法获取视频字幕、评论

在开始安装前，请确保您已经了解如何获取并配置 Cookie。

🌟 功能特性

1. 视频总结 (`get_video_info`)

优先获取视频的 CC 或 AI 字幕
无字幕时自动降级为视频标题、简介和标签
支持多语言字幕选择（默认优先简体中文）
可手动指定偏好字幕语言（如 en, zh-Hant 等）

2. 评论总结 (`get_video_comments`)

获取视频热门评论，辅助判断视频真实口碑
自动过滤表情占位符（如 [doge]）以保持文本整洁
优先保留包含时间戳的评论（如 05:20），方便定位高能片段
支持两种详细程度：
- brief: 10 条热门评论速览
- detailed: 50 条热门评论 + 高赞连带回复

📋 环境要求

Node.js: v18.0.0 或更高版本
Bilibili 账号凭证 (Cookie)

🚀 安装方式

🖱️ Cursor

Cursor 同样原生支持 MCP，你可以通过图形界面快速添加：

打开 Cursor 设置：Cursor Settings > Features > MCP Servers
点击 + Add New MCP Server
填写以下信息：
- Name: bilibili-mcp (或任意你喜欢的名字)
- Type: 选择 command
- Command: npx -y @xzxzzx/bilibili-mcp （如果 Windows 遇到路径问题，可尝试 cmd /k npx -y @xzxzzx/bilibili-mcp）
点击 Add 保存。配置完成后，可能需要点击列表旁的刷新按钮来加载工具库。

提示：高级用户也可直接在项目根目录创建 .cursor/mcp.json 配置文件。

Claude Code

方法一：通过 CLI 命令快速安装（推荐）

直接在终端运行以下命令：

claude mcp add bilibili-mcp --command "npx" --args "-y" --args "@xzxzzx/bilibili-mcp"

完成后重启 Claude Code 即可使用。

方法二：通过配置文件手动添加（高级）

打开 Claude Code 配置文件（通常在 ~/.claude.json）
在 mcpServers 节点下添加：

{
  "mcpServers": {
    "bilibili-mcp": {
      "command": "npx",
      "args": ["-y", "@xzxzzx/bilibili-mcp"]
    }
  }
}

保存后重启 Claude Code。

Claude Desktop (桌面客户端)

Claude Desktop 支持通过全局配置文件接入 MCP 服务器：

打开 Claude Desktop 配置文件：
- Windows 路径：%APPDATA%\Claude\claude_desktop_config.json
- macOS 路径：~/Library/Application Support/Claude/claude_desktop_config.json
- 提示：您也可以在 Claude Desktop 的 Settings -> Developer 中点击 Edit Config 直接打开该文件。
在 mcpServers 节点下添加：

{
  "mcpServers": {
    "bilibili-mcp": {
      "command": "npx",
      "args": ["-y", "@xzxzzx/bilibili-mcp"]
    }
  }
}

保存文件并从侧边栏重启或重新开启对话。

方法三：通过 npm 全局安装

安装后可直接使用命令行工具管理配置：

npm install -g @xzxzzx/bilibili-mcp

安装验证与检查：

bilibili-mcp --help （查看帮助）
bilibili-mcp config （通过交互向导配置 Cookie）
bilibili-mcp check （检查配置状态）

🏗️ Trae (字节跳动官方 IDE)

Trae 提供了非常便捷的 MCP 接入界面，国内/国际版操作一致：

打开 Trae 设置：点击左下角齿轮 -> Settings (或 Cmd/Ctrl + ,)。
找到 AI 选项卡 -> MCP。
点击 Add Server 按钮。
在弹出窗口中填写：
- Name: bilibili-mcp
- Type: 选择 command (stdio)
- Command: npx
- Arguments: ["-y", "@xzxzzx/bilibili-mcp"]
点击 Save。

提示：Trae 也会自动识别项目根目录下的 .trae/mcp_config.json 文件。

🌊 Windsurf (Codeium 官方 IDE)

Windsurf 同样支持通过标准 JSON 配置文件接入：

打开 Windsurf 设置：Cmd/Ctrl + , -> 在左侧点击 Advanced -> Cascade。
点击 Add custom server + 或 View raw config（这将打开 mcp_config.json）。
如果是手动编辑，文件路径通常为：
- Windows: %USERPROFILE%\.codeium\windsurf\mcp_config.json
- macOS/Linux: ~/.codeium/windsurf/mcp_config.json
在 mcpServers 节点下添加：

{
  "mcpServers": {
    "bilibili-mcp": {
      "command": "npx",
      "args": ["-y", "@xzxzzx/bilibili-mcp"]
    }
  }
}

保存并重启 Windsurf 后，在 Cascade 面板即可看到新添加的工具。

⚡ Zed

Zed 编辑器通过 settings.json 配置文件中的 context_servers 字段来支持 MCP：

打开 Zed 的设置文件：Cmd + , (macOS) 或 Ctrl + , (Windows/Linux)。
在 JSON 配置文件中添加 (或修改) context_servers 节点：

{
  "context_servers": {
    "bilibili-mcp": {
      "command": "npx",
      "args": ["-y", "@xzxzzx/bilibili-mcp"]
    }
  }
}

保存文件。Zed 桌面端会自动重启 Context Server。
在编辑器中通过 / 触发 AI 辅助时，可以看到来自该服务器的 Context 或工具。

♊ Gemini CLI (Google 官方命令行工具)

Gemini CLI 通过全局或项目级的 settings.json 文件管理 MCP 服务器：

找到全局配置文件：
- Windows: %USERPROFILE%\.gemini\settings.json
- macOS/Linux: ~/.gemini/settings.json
在 mcpServers 节点下添加：

{
  "mcpServers": {
    "bilibili-mcp": {
      "command": "npx",
      "args": ["-y", "@xzxzzx/bilibili-mcp"]
    }
  }
}

如果您是通过项目级配置，请在项目根目录创建 .gemini/settings.json。
保存后，运行 gemini 命令时即可调用相关工具。

国内版提示：如果您在国内环境下使用，请确保已正确配置 HTTP_PROXY 或 HTTPS_PROXY 环境变量，以便 npx 顺利下载包以及 CLI 能够访问 Google API。

⌨️ Codex CLI (OpenAI 官方命令行工具)

Codex CLI 使用 TOML 格式的配置文件，并支持通过命令行快速添加：

方式一：通过命令行添加（推荐） 直接在终端运行：

codex mcp add bilibili-mcp -- npx -y @xzxzzx/bilibili-mcp

方式二：手动修改配置文件

找到配置文件：
- 全局路径：~/.codex/config.toml
- 项目路径：.codex/config.toml
添加以下内容：

[mcp_servers.bilibili-mcp]
command = "npx"
args = ["-y", "@xzxzzx/bilibili-mcp"]

保存后重启 Codex CLI 即可识别工具。

🪐 Antigravity (Google 官方 IDE)

Antigravity 原生支持 MCP 协议。你可以通过 UI 界面或直接修改配置文件来添加：

方式一：通过界面添加（推荐）

在编辑器侧边栏顶部点击 ... 下拉菜单，打开 MCP Store 面板。
点击 Manage MCP Servers -> View raw config。
参考下方 JSON 格式填入配置。

方式二：手动修改配置文件

Windows 路径：%USERPROFILE%\.gemini\antigravity\mcp_config.json
macOS/Linux 路径：~/.gemini/antigravity/mcp_config.json

在 mcpServers 节点下添加：

{
  "mcpServers": {
    "bilibili-mcp": {
      "command": "npx",
      "args": ["-y", "@xzxzzx/bilibili-mcp"]
    }
  }
}

保存后配置即刻生效。

📦 OpenCode

OpenCode 用户可以通过编辑配置文件接入：

编辑 ~/.config/opencode/opencode.json
在 mcp 节点下添加以下内容：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "bilibili-mcp": {
      "type": "local",
      "command": ["npx", "-y", "@xzxzzx/bilibili-mcp"],
      "enabled": true
    }
  }
}

⚙️ 凭证配置

为了获取更完整的评论数据、绕过匿名访问限制并确保工具稳定运行，必须配置 B 站 Cookie。

🔑 第一步：获取 Bilibili Cookie

在电脑浏览器登录 bilibili.com
按 F12 打开开发者工具（或在页面右键选择“检查”）。
切换到 Application (应用) 选项卡 -> 在左侧菜单找到 Cookies -> 点击 https://www.bilibili.com。
在右侧列表中找到以下三个关键变量，并记录它们的 Value：
- SESSDATA
- bili_jct (即 CSRF Token)
- DedeUserID (您的用户数字 ID)

[!TIP] 如果您在 Application 找不到，也可以查看 Network (网络) 选项卡中的任意一个请求，在 Headers -> Cookie 字段中也能找到这些值。

📝 第二步：应用凭证

您可以针对不同的使用习惯选择以下任一方式：

方式 A：使用 CLI 向导（推荐，适用于全局安装）

如果您全局安装了 npm 包（npm i -g @xzxzzx/bilibili-mcp），直接运行：

bilibili-mcp config

交互向导将引导您输入凭证并安全保存在本地配置目录（~/.bilibili-mcp/config.json）中。

方式 B：手动配置环境变量（适用于本地开发或 Docker）

在项目根目录创建 .env 文件，手动填入以下变量：

[!WARNING] .env 文件仅供本地加载，切勿提交到 Git 或公开仓库。

🔒 安全须知

隐私保护：您的凭证信息仅存储在您的本地设备上。本工具绝不会将其上传至除 Bilibili 官方 API 以外的任何第三方服务器。
配置隔离：.env 文件已被 .gitignore 排除。
时效性：Cookie 具有时效性。若遇到 412 或权限错误，请尝试更新 Cookie。

💡 工具使用示例

在支持 MCP 的对话流中，你可以直接输入自然语言，底层会自动调用对应的 JSON 格式配置：

// 获取默认语言视频信息
{
  "name": "get_video_info",
  "arguments": { "bvid_or_url": "BV1xx4x1x7xx" }
}

// 获取 10 条简短评估
{
  "name": "get_video_comments",
  "arguments": { "bvid_or_url": "BV1xx4x1x7xx", "detail_level": "brief" }
}

🛡️ API 限流机制

为保证工具长效可用并合规调用底层接口，已内置以下限流策略：

请求间隔：500ms（0.5秒）
执行方式：加入队列顺序处理，禁止大并发请求。

🛠️ 开发指南

# 1. 克隆仓库
git clone https://github.com/365903728-oss/bilibili-mcp.git
cd bilibili-mcp

# 2. 安装依赖包
npm install

# 3. 启动监听与实时编译
npm run watch

本工具输出报错信息统一使用 console.error，以避免干扰 Stdio 协议数据。

⚖️ 安全性与免责声明

⚠️ 重要：使用本工具即代表您同意以下条款

商标声明：Bilibili (哔哩哔哩) 是哔哩哔哩公司的注册商标。本项目为基于公开协议的第三方开源辅助工具。
协议精神：本项目仅供个人学习、辅助阅读使用。坚决抵制任何用于商业剥削、大规模滥用抓取等违规操作。
责任归属：所有请求均为用户本地发起。开发者不对由于高频使用等原因导致的账号风控或其他后果负责。
隐私保护：本工具严格保护用户隐私，所有凭证信息仅在本地加密/非加密存储，除与 Bilibili 官方接口通信外，无任何后台上传行为。

许可证

基于 GNU General Public License v3.0 开源。