Skip to main content

用于哔哩哔哩 API 的 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.0.tar.gz (7.3 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.0-py3-none-any.whl (7.9 kB view details)

Uploaded Python 3

File details

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

File metadata

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

File hashes

Hashes for bilibili_mcp_tools-0.1.0.tar.gz
Algorithm Hash digest
SHA256 e25d0da07ca3bf983fbfcc7d87746d1bb29e337731552b28c6d90a3dd1ddac2a
MD5 fdb824c9a7d2aa5a7798c1c18e2b410d
BLAKE2b-256 e98e92281fa0cbc193bcdf93fb6615df3435c2a7f8a5102e12a675d154fbffd6

See more details on using hashes here.

File details

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

File metadata

File hashes

Hashes for bilibili_mcp_tools-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 8bc2fd583ce7ea9a73e0f3c3b6147a08eb58962c56f75d30a5c06540b1900078
MD5 b02aa0775747d0d0374dab6727148a7d
BLAKE2b-256 0fa75383fb6a17068085af7a4ba408bb9a6d19ad966f4c0f289c102b4ae30c91

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