Bilibili MCP工具

📋 环境要求

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

---

2. 安装依赖包

npm install

⚡ 快速开始

选择你正在使用的 AI 客户端，点击后可直接跳转到详细配置方法：

• Codex app / Codex CLI
• Claude Code
• Claude Desktop
• OpenCode
• OpenClaw
• Hermes
• WorkBuddy
• CodeBuddy
• Trae CN
• Trae International
• Trae SOLO CN
• Trae SOLO International
• Antigravity / Antigravity CLI
• Pi
• Oh My Pi
• Crush
• DeepSeek-TUI
• Deep Code
• Reasonix
• Langcli
• GitHub Copilot CLI
• Cursor
• Cline
• Kilo Code
• VS Code
• GitHub Copilot (VS Code)
• Windsurf
• Zed
• Cherry Studio
• LobeHub / LobeChat
• AstrBot
• nanobot

---

3. 启动监听与实时编译

npm run watch ```

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

---

💡 工具调用示例

AI 客户端会自动将你的自然语言意图转换为对应的 JSON 调用。

⚙️ 凭证配置

为了稳定获取字幕、转录和评论，建议配置 Bilibili Cookie。公开视频元数据可能无需 Cookie，但不要依赖无 Cookie 模式获取字幕或评论。

环境变量方式

适合 Docker、本地开发或手动配置 MCP 客户端环境变量。

.env 示例：

BILIBILI_SESSDATA=<your_sessdata>
BILIBILI_BILI_JCT=<your_bili_jct>
BILIBILI_DEDEUSERID=<your_dedeuserid>

推荐方式：CLI 向导

npm install -g @xzxzzx/bilibili-mcp
bilibili-mcp config
bilibili-mcp check

CLI 会把凭证保存在本地配置目录，不会写入仓库。

🛡️ API 限流机制

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

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

---

VS Code

VS Code 原生支持 MCP 配置。工作区配置可通过命令面板打开：

MCP: Open Workspace Folder MCP Configuration

这会创建或打开：

.vscode/mcp.json

添加：

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

用户级配置可用命令面板打开：

MCP: Open User Configuration

VS Code MCP 还支持 HTTP、SSE、Windows named pipe 和 Unix socket。配置后可在 VS Code 的 MCP server 列表中启动、停止或查看 server 状态。使用本项目时不要把真实 Cookie 写进 .vscode/mcp.json。

GitHub Copilot (VS Code)

GitHub Copilot Chat 在 VS Code 中读取 VS Code MCP 配置。工作区配置可写入：

.vscode/mcp.json

添加：

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

也可以用命令面板打开 MCP: Open User Configuration 配置全局 MCP。配置后在 Copilot Chat Agent Mode 中使用该 server 的工具。