MCP 服务器

Bilibili Mcp Server Unofficial(video Subtitles And Comments)

✨ 为你的 AI 助手装上 B 站的眼睛：一键提取视频字幕与热门评论，助力高效信息总结 🚀 ✨ Equip your AI assistant with "Bilibili Eyes": One-click extraction of video subtitles and popular comments for efficient information summarization 🚀

README

Bilibili MCP Tool

✨ 为你的 AI 助手装上 B 站的眼睛：一键提取视频字幕与热门评论，助力高效信息总结 🚀

✨ Equip your AI assistant with "Bilibili Eyes": One-click extraction of video subtitles and popular comments for efficient information summarization 🚀

🌐 English Documentation (English read me version here)
📜 更新日志 (Changelog)

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

⚠️ Notice: Please make sure to configure your Bilibili Cookies before use, otherwise video subtitles and comments cannot be extracted. See ⚙️ Credential Configuration (Cookies are only stored locally and will not be uploaded anywhere).

📑 目录

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 条热门评论 + 高赞连带回复

3. 🛡️ 稳健性增强

Cookie 过期智能检测：当字幕获取为空时自动验证登录状态，区分“无字幕视频”与“凭证失效”，并抛出明确的 COOKIE_EXPIRED 错误，避免静默降级。

📋 环境要求

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"],
      "env": {
        "BILIBILI_SESSDATA": "你的_SESSDATA",
        "BILIBILI_BILI_JCT": "你的_bili_jct",
        "BILIBILI_DEDEUSERID": "你的_DedeUserID"
      }
    }
  }
}

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

方法二：通过 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 文件，手动填入以下变量：

变量名	说明
BILIBILI_SESSDATA	`SESSDATA` 的值
BILIBILI_BILI_JCT	`bili_jct` 的值
BILIBILI_DEDEUSERID	`DedeUserID` 的值

[!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 开源。

🛠️ 开发过程

本项目是一个典型的 AI 协同开发的结晶，完整经历了从原型到完善的过程：

初版生成：由 Claude Code (搭载 GLM-4.7 模型) 快速搭建核心架构与基础逻辑。
调试与优化：在 Antigravity 环境下，利用 Claude 和 Gemini 模型进行深度的 Bug 修复与功能增强，确保了字幕提取与评论分析的稳定性。

💬 反馈与建议

如果您在使用过程中遇到任何问题，或者有好的功能建议，欢迎通过以下方式联系：

提交 Issue：GitHub Issues —— 推荐方式，我会定期查看并回复。
项目讨论：在 GitHub Discussions（如果已开启）中交流。

感谢您的支持！