Skip to main content

哔哩哔哩 MCP 服务器 - 支持搜索、弹幕、用户信息等功能的模型上下文协议服务器

Project description

Bilibili API MCP Server

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

环境要求

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

使用方法

  1. clone 本项目

  2. 使用 uv 安装依赖

uv sync
  1. 在任意 mcp client 中配置本 Server
{
  "mcpServers": {
    "bilibili": {
      "command": "uv",
      "args": [
        "--directory",
        "/your-project-path/bilibili-mcp-server",
        "run",
        "bilibili.py"
      ]
    }
  }
}
  1. 在 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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bilibili_mcp_tools-0.1.1.tar.gz (9.5 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

bilibili_mcp_tools-0.1.1-py3-none-any.whl (11.5 kB view details)

Uploaded Python 3

File details

Details for the file bilibili_mcp_tools-0.1.1.tar.gz.

File metadata

  • Download URL: bilibili_mcp_tools-0.1.1.tar.gz
  • Upload date:
  • Size: 9.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.1.0 CPython/3.11.12

File hashes

Hashes for bilibili_mcp_tools-0.1.1.tar.gz
Algorithm Hash digest
SHA256 b49134876adb00f39288bf2ceb6c4e76000ec6c57e68c56b71f4b6638cdea044
MD5 46b1f9e5658999028d213b5730b67055
BLAKE2b-256 1221919523e93758fb26344225c18901bf7563260652695432a2e8cf28e46945

See more details on using hashes here.

File details

Details for the file bilibili_mcp_tools-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for bilibili_mcp_tools-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8c3c3611ef445ce8cb5cabd69ca3b514734116cd421af11b473f10d01b5e1e66
MD5 83ae680bd56d641ab7a0179aba1fbf8c
BLAKE2b-256 3653ddf2296db38129f296b33da5a1df07f0af11b209dfed0f0d618f390bf8ab

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page