Bilibili Api Mcp Server

Bilibili API MCP サーバー

哔哩哔哩 API 用の MCP（モデルコンテキストプロトコル）サーバーで、さまざまな操作に対応しています。

環境要件

• uv - 依存関係を簡単に管理できるプロジェクト管理ツールです。

使用方法

方法 1：PyPI 経由で使用する（推奨）

任意の MCP クライアントでこのサーバーを設定すると、システムが自動的にダウンロードして有効化します。

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

💡 ヒント：プロジェクトのルートディレクトリにある mcp-config.json ファイルを設定例として直接使用することもできます。

方法 2：ローカルで開発・実行する

1. このプロジェクトをクローンします。

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

2. uv を使用して依存関係をインストールします。

uv sync

3. 任意の MCP クライアントでこのサーバーを設定します。

{
  "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 番号を自動的に抽出します
   • 複数パートの動画の弾幕取得に対応しています
   • 動画の詳細情報と弾幕データを返します

免責事項

本プロジェクトでは、開発およびテスト中に、哔哩哔哩の UP 主 技术爬爬虾 の公開コンテンツをサンプルデータとして使用しています。

本プロジェクトは技術学習および研究のみを目的としており、サンプルデータの使用はすべて哔哩哔哩プラットフォームの利用規約に従っています。著作権に関する問題がございましたら、プロジェクトのメンテナーまでご連絡ください。

ライセンス

MIT