@mcpcn/mcp-bilibili

v1.0.14

Published

6 months ago

B站开放平台 MCP 服务器，支持用户认证、视频管理、完整的视频投稿流程

0High
0Medium
0Low

mcp bilibili oauth2 video upload model-context-protocol

MCP Bilibili Server

一个基于 MCP (Model Context Protocol) 的B站开放平台集成服务，支持用户认证、视频管理、完整的视频投稿流程等功能。

🚀 功能特性

🔐 用户认证系统

本地Token缓存: 自动缓存访问令牌，避免频繁授权
OAuth 2.0安全认证: 采用B站官方授权机制
扫码快速授权: 自动打开浏览器，手机扫码即可完成授权

📊 用户信息管理

基础信息查询: 获取用户昵称、头像、openid等
统计数据获取: 关注数、粉丝数、投稿数等维度数据
投稿历史查询: 查看已发布的视频列表及详细信息

🎬 完整投稿流程

视频分区查询: 获取所有可用的投稿分区
一键视频上传: 整合了视频上传、封面上传、分类查询和稿件提交的完整流程
智能分片上传: 自动处理大文件分片上传和合并
封面自动上传: 支持JPEG、PNG格式封面自动上传
稿件智能提交: 完成视频发布到B站并返回BV号

📦 安装配置

方式一：NPX 直接运行（推荐）

# 如果遇到模块依赖问题，可以先本地安装
npm install -g @mcpcn/mcp-bilibili

# 然后直接运行
mcp-bilibili

方式二：本地开发安装

# 克隆项目
git clone https://github.com/mcpcn/mcp-servers
cd mcp-servers/typescript/mcp-bilibili

# 安装依赖
npm install

# 构建项目
npm run build

# 运行
npm start

方式三：MCP 客户端配置

在你的 MCP 客户端配置文件中添加：

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

或者使用本地安装：

{
  "mcpServers": {
    "bilibili": {
      "command": "mcp-bilibili"
    }
  }
}

🎯 完整使用流程

第一步：用户认证

# 1. 检查本地是否有有效token
bilibili_check_local_token

# 2. 如果没有，生成授权链接（会自动打开浏览器）
bilibili_web_authorize_link

# 3. ⚠️ 重要：扫码授权后，必须“原样复制”上一步响应中的 state 字段用来换取访问令牌
# 注意：state 是本次授权流程的唯一标识，必须逐字复制粘贴。不要使用占位示例（如“授权后返回的state值”）或任何自造内容，否则将会超时失败！
bilibili_web_poll_and_token --state "返回的state值"

⚠️ 重要提醒：授权时请确保勾选所有权限项目：
📱 基础信息
📊 投稿效果管理
🎬 UP主视频稿件管理
📈 视频稿件数据管理

第二步：查询用户信息

# 获取用户基本信息
bilibili_get_user_info --access_token "你的token"

# 获取用户统计数据
bilibili_get_user_stat --access_token "你的token"

# 查看投稿历史
bilibili_get_video_list --access_token "你的token"

第三步：视频投稿流程

# 1. 获取可用分区列表
bilibili_get_video_categories --access_token "你的token"

# 2. 视频上传预处理
bilibili_upload_video_preprocess --access_token "你的token" --filename "video.mp4"

# 3. 上传视频分片（支持大文件）
bilibili_upload_video_chunk --upload_token "预处理返回的token" --video_file_path "/path/to/video.mp4"

# 4. 完成视频分片合并
bilibili_complete_video_upload --upload_token "预处理返回的token"

# 5. 上传封面图片
bilibili_upload_cover --access_token "你的token" --cover_file_path "/path/to/cover.jpg"

# 6. 提交稿件完成投稿
bilibili_submit_archive --access_token "你的token" --upload_token "预处理返回的token" --title "视频标题" --tag "标签1,标签2" --tid 分区ID --cover "封面URL"

🛠️ API 工具详细说明

认证相关

`bilibili_check_local_token`

检查本地缓存的访问令牌是否有效

参数: 无

{
  "hasValidToken": true,
  "access_token": "有效的访问令牌",
  "refresh_token": "刷新令牌", 
  "expires_at": 1640995200,
  "message": "Token有效"
}

`bilibili_web_authorize_link`

生成B站授权链接并自动打开浏览器

参数: 无

{
  "state": "unique_state_id",
  "authorize_url": "https://passport.bilibili.com/oauth2/authorize?...",
  "tips": "已自动在本地浏览器打开授权链接，请扫码授权"
}

`bilibili_web_poll_and_token`

轮询获取授权码并换取访问令牌

参数:

state: 授权时生成的唯一标识

{
  "access_token": "访问令牌",
  "refresh_token": "刷新令牌",
  "expires_in": 2592000
}

用户信息

`bilibili_get_user_info`

获取用户基本信息

参数:

access_token: 访问令牌

{
  "name": "用户昵称",
  "face": "头像URL",
  "openid": "用户唯一标识"
}

`bilibili_get_user_stat`

获取用户统计数据

参数:

access_token: 访问令牌

{
  "following": 123,
  "follower": 456,
  "arc_passed_total": 78
}

`bilibili_get_video_list`

获取用户投稿视频列表

参数:

access_token: 访问令牌

返回: 包含视频ID、标题、封面、分区、状态等信息的数组

视频投稿

`bilibili_get_video_categories`

获取B站视频分区列表

参数:

access_token: 访问令牌

[
  {
    "id": 188,
    "parent": 3,
    "name": "科技",
    "desc": "科技分区描述"
  }
]

🎬 一键视频上传功能

`bilibili_upload_video` - 整合视频上传工具

🎯 功能说明: 一键完成视频上传、封面上传、分类查询和稿件提交的完整流程

参数:

access_token: 访问令牌
video_file_path: 本地视频文件路径（如: /path/to/video.mp4）
title: 视频标题（长度小于80字符）
tag: 视频标签（多个标签用英文逗号分隔，总长度小于200字符）
tid: 分区ID（可通过 bilibili_get_video_categories 获取）
cover_file_path: 本地封面图片路径（可选，如: /path/to/cover.jpg）
desc: 视频描述（可选，长度小于250字符）
copyright: 版权类型（1-原创，2-转载，默认1）
no_reprint: 是否禁止转载（0-允许转载，1-禁止转载，默认0）
source: 转载来源（copyright为2时必填）

{
  "success": true,
  "resource_id": "BV1xx411c7mD",
  "message": "视频上传成功！",
  "steps": [
    "1. 开始视频上传预处理...",
    "✅ 视频上传预处理完成",
    "2. 开始上传视频文件...",
    "✅ 视频文件上传完成",
    "3. 开始视频合片...",
    "✅ 视频合片完成",
    "4. 开始上传封面图片...",
    "✅ 封面图片上传完成",
    "5. 开始提交视频稿件...",
    "✅ 视频稿件提交完成"
  ]
}

使用示例:

# 上传一个原创视频
bilibili_upload_video \
  --access_token "your_access_token" \
  --video_file_path "/Users/username/Videos/my_video.mp4" \
  --title "我的第一个B站视频" \
  --tag "教程,编程,技术分享" \
  --tid 188 \
  --cover_file_path "/Users/username/Pictures/cover.jpg" \
  --desc "这是一个关于编程的教程视频"

# 上传转载视频
bilibili_upload_video \
  --access_token "your_access_token" \
  --video_file_path "/Users/username/Videos/repost_video.mp4" \
  --title "转载：有趣的编程技巧" \
  --tag "转载,编程,技巧" \
  --tid 188 \
  --copyright 2 \
  --source "原作者：张三"

⚠️ 注意事项:

视频文件路径必须是本地绝对路径
封面文件路径必须是本地绝对路径（可选）
标题长度小于80字符
描述长度小于250字符（可选）
标签用英文逗号分隔，总长度小于200字符
分区ID可通过 bilibili_get_video_categories 获取
上传过程中会自动处理分片上传和合并
支持大文件上传，无需手动分片

🔧 工具列表总结

认证相关工具

bilibili_check_local_token - 检查本地Token缓存
bilibili_web_authorize_link - 生成授权链接
bilibili_web_poll_and_token - 获取访问令牌

用户信息工具

bilibili_get_user_info - 获取用户基本信息
bilibili_get_user_stat - 获取用户统计数据
bilibili_get_video_list - 获取投稿视频列表

视频管理工具

bilibili_get_video_categories - 获取视频分区列表
bilibili_upload_video - 🎯 一键视频上传（整合工具）

💡 提示: 现在只需要使用 bilibili_upload_video 一个工具就可以完成完整的视频上传流程，包括视频上传、封面上传、分类查询和稿件提交！ "url": "https://archive.biliimg.com/bfs/archive/xxx.jpg" }


#### `bilibili_submit_archive`
提交视频稿件



## 📋 使用限制

### 文件要求
- **视频文件**: ≤4GB，时长≤5小时
- **封面图片**: JPEG/PNG格式，≤5MB
- **标题**: 长度<80字符，短时间内不能重复
- **描述**: 长度<250字符
- **标签**: 总长度<200字符

### 投稿限制
- **非正式会员**: 单日最多5个稿件
- **审核时间**: 几分钟到几小时不等
- **权限要求**: 需要授权所有4个权限项目

## 🏗️ 项目结构

mcp-bilibili/ ├── index.ts # MCP服务器主程序 ├── oauth.ts # OAuth认证功能 ├── user.ts # 用户信息API ├── video.ts # 视频管理和投稿API ├── package.json # 项目依赖 ├── tsconfig.json # TypeScript配置 └── README.md # 使用文档


## 🔐 安全说明

本工具采用B站官方OAuth 2.0授权机制：
- ✅ **用户数据安全**: 数据完全由用户控制，应用无法获取密码
- ✅ **权限可控**: 用户可选择授权哪些权限
- ✅ **标准协议**: 遵循OAuth 2.0国际标准
- ✅ **Token缓存**: 本地安全存储，避免频繁授权

### 📁 Token存储位置
Token缓存文件统一存储在用户主目录的 `.mcp` 目录下：

~/.mcp/bilibili-mcp/token.json


这种设计避免了在用户主目录下散落各种MCP配置文件，保持目录整洁。

## 📚 参考文档

- [B站开放平台文档](https://open.bilibili.com/doc/)
- [MCP (Model Context Protocol)](https://modelcontextprotocol.io/)
- [OAuth 2.0 RFC](https://tools.ietf.org/html/rfc6749)

## 📄 许可证

MIT License

## 🤝 贡献

欢迎提交 Issue 和 Pull Request 来改进这个项目！

---

**注意**: 使用本工具需要遵守B站开放平台的使用条款和社区规范。

## 🔧 故障排除

### NPX 模块依赖错误
如果使用 `npx @mcpcn/mcp-bilibili` 时遇到模块找不到的错误：

1. **清理NPX缓存**：
```bash
npx clear-npx-cache

全局安装（推荐）：

npm install -g @mcpcn/mcp-bilibili
mcp-bilibili

本地开发安装：

git clone https://github.com/mcpcn/mcp-servers
cd mcp-servers/typescript/mcp-bilibili
npm install && npm run build && npm start

Node.js 版本要求

确保您的 Node.js 版本 >= 18.0.0：

node --version