Metadata-Version: 2.4
Name: bilibili-api-mcp-server
Version: 0.1.3
Summary: 用于哔哩哔哩 API 的 MCP（模型上下文协议）服务器，支持多种操作
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: bilibili-api-python>=17.3.0
Requires-Dist: mcp[cli]>=1.12.3

# Bilibili API MCP Server

用于哔哩哔哩 API 的 MCP（模型上下文协议）服务器，支持多种操作。

## 环境要求

- [uv](https://docs.astral.sh/uv/) - 一个项目管理工具，可以很方便管理依赖。

## 使用方法

### 方式一：通过 PyPI 使用（推荐）

在任意 MCP client 中配置本 Server，系统会自动下载和启用

```json
{
  "mcpServers": {
    "bilibili": {
      "type": "stdio",
      "isActive": true,
      "command": "uvx",
      "args": [
        "bilibili-api-mcp-server"
      ]
    }
  }
}
```

> 💡 **提示**：您也可以直接使用项目根目录下的 `mcp-config.json` 文件作为配置参考。

### 方式二：本地开发运行

1. clone 本项目

```bash
git clone https://github.com/SMYB5431/bilibili-api-mcp-server.git
cd bilibili-api-mcp-server
```

2. 使用 uv 安装依赖

```bash
uv sync
```

3. 在任意 MCP client 中配置本 Server

```json
{
  "mcpServers": {
    "bilibili": {
      "command": "uvx",
      "args": [
        "--directory",
        "/your-project-path/bilibili-api-mcp-server",
        "run",
        "bilibili.py"
      ]
    }
  }
}
```

### 开始使用

## 支持的操作

支持以下操作：

### 基础搜索功能
1. `search_and_recommend_videos`: 智能视频搜索和推荐功能。
   - 按综合排序搜索视频内容
   - 自动过滤课堂视频（cheese链接）
   - 返回前15条视频结果（可自定义数量）
   - 基于搜索结果提供推荐理由
   - 分析视频质量和热度
   - 生成内容总结和推荐报告

2. `search_user`: 专门用于搜索哔哩哔哩用户的功能，可以按照粉丝数排序。

3. `get_user_id_by_name`: 通过用户名获取用户ID，支持精确搜索和详细信息返回。
   - 默认模式：只返回用户ID，用于快速获取用户标识
   - 详细模式：返回完整用户信息和精确匹配状态
   - 精确匹配：优先返回完全匹配用户名的结果
   - 错误处理：提供详细的错误信息和异常处理

### 用户内容获取功能
4. `get_user_dynamics`: 获取指定用户的最新动态。
   - 支持通过用户名直接获取（如"技术爬爬虾"）
   - 可指定获取动态数量（默认10条）
   - 返回动态内容、时间戳、链接等信息

5. `get_user_videos`: 获取指定用户的最新投稿视频。
   - 支持通过用户名直接获取
   - 可指定获取视频数量（默认10条）
   - 返回视频标题、BV号、播放量、时长等详细信息

6. `get_user_collections`: 获取指定用户的合集信息。
   - 支持通过用户名直接获取
   - 返回合集标题、视频数量、播放量等信息
   - 包含合集链接便于访问

7. `get_collection_videos`: 获取指定合集中的视频列表。
   - 支持通过合集名称或合集ID获取
   - 可指定获取视频数量（默认10条）
   - 返回视频详细信息（标题、播放量、点赞数、投币数等）
   - 支持模糊匹配合集名称

8. `search_collection_by_keyword`: 在用户合集中搜索包含关键词的视频。
   - 支持在所有合集中搜索特定关键词
   - 返回匹配的合集及其视频列表
   - 适用于快速定位特定主题的视频内容

### 其他功能
9. `get_video_danmaku`: 获取视频弹幕信息。
   - 支持视频链接或BV号输入
   - 自动从链接中提取BV号
   - 支持多分P视频的弹幕获取
   - 返回详细的视频信息和弹幕数据

## 声明

本项目在开发和测试过程中使用了哔哩哔哩 UP主 [技术爬爬虾](https://space.bilibili.com/316183842) 的公开内容作为示例数据。

本项目仅用于技术学习和研究目的，所有示例数据的使用均遵循哔哩哔哩平台的使用条款。如有任何版权问题，请联系项目维护者。

## License

MIT
