Bilibili API MCP Server

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

环境要求

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

使用方法

1. clone 本项目

2. 使用 uv 安装依赖

uv sync

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

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

4. 在 client 中使用

支持的操作

支持以下操作：

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

如何为本项目做贡献

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

🎉 更新内容

本项目现在包含了完整的打包和部署解决方案：

📦 打包选项

1. Python包打包（推荐）

   python build.py
   pip install dist/*.whl
   

2. Docker容器化

   docker build -t bilibili-mcp-server .
   docker-compose up -d
   

3. 自动化安装

   python install.py
   

🚀 快速开始

# 1. 自动安装和配置
python install.py

# 2. 或者手动构建
python build.py

# 3. 运行演示
python example.py

📋 生成的配置文件

• mcp_config.json - 开发模式配置 (uv run)
• mcp_config_pip.json - pip安装模式配置
• mcp_config_uvx.json - uvx运行配置 (推荐)
• mcp_config_wheel.json - 直接从wheel包运行
• docker-compose.yml - Docker部署配置
• Dockerfile - 容器构建文件

📚 详细文档

查看 PACKAGING.md 获取完整的打包指南和使用说明。

License

MIT