返回 MCP 目录
public公开dns本地运行

Bilibili Search

哔哩哔哩API的MCP服务器,支持多种B站数据操作

article

README

🚀 B站 API MCP 服务器

本项目是用于管理B站 API 的 MCP(模型上下文协议)服务器,支持多种操作,可助力用户高效管理和使用B站相关 API。

🚀 快速开始

环境要求

  • uv - 一个项目管理工具,可以方便地管理依赖。

使用方法

  1. 克隆本项目
  2. 使用 uv 安装依赖
uv sync
  1. 在任意 MCP 客户端中配置本 Server
{
  "mcpServers": {
    "bilibili": {
      "command": "uv",
      "args": [
        "--directory",
        "/your-project-path/bilibili-mcp-server",
        "run",
        "bilibili.py"
      ]
    }
  }
}
  1. 在客户端中使用

✨ 主要特性

支持以下操作:

  1. general_search:基础搜索功能,使用关键词在B站进行搜索。
  2. search_user:专门用于搜索B站用户的功能,可以按粉丝数排序。
  3. get_precise_results:精确搜索功能,可以过滤掉不必要的信息,支持多种搜索类型:
    • 用户搜索 (user):精确匹配用户名,只返回完全匹配的结果。例如搜索"双雷"只会返回用户名为"双雷"的账号信息,不会返回其他相关用户。
    • 视频搜索 (video)
    • 直播搜索 (live)
    • 专栏搜索 (article) 返回结果包含 exact_match 字段,标识是否找到精确匹配的结果。
  4. get_video_danmaku:获取视频弹幕信息。

💻 使用示例

基础用法

uv sync

高级用法

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

🤝 如何为本项目做贡献

  1. Fork 本项目
  2. 新建分支,并在新的分支上进行改动
  3. 提交 PR

📄 许可证

本项目采用 MIT 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端