Bilibili MCP

🚀 ビリビリホットランキングツール（bilibili-mcp）

FastMCP とビリビリの公開APIをベースにした MCP ツールで、ビリビリのホットランキング動画データを取得することができます。Cursor や他の MCP クライアントに登録することで、リアルタイムにホット動画情報を呼び出すことができます。

🚀 クイックスタート

1. 依存関係のインストール

Python バージョンが ≥3.12 であることを確認し、以下の依存関係をインストールしてください。

pip install httpx "mcp[cli]>=1.6.0"

2. プロジェクト構造の例

メインコードファイルは bilibili_mcp.py とすることができ、プロジェクト構造は次のようになります。

bilibili_mcp/
├── bilibili_mcp.py
├── pyproject.toml
└── README.md

3. MCP サービスの起動

uv を使用してツールを実行します。

uv tool run bilibili-mcp

または、設定ファイルを参照して実行することもできます。

"bilibili-j": {
  "command": "uv",
  "args": [
    "tool",
    "run",
    "bilibili-mcp"
  ]
}

4. ツールの登録

FastMCP は自動的に get_popular という名前のツールを公開します。

📦 get_popular(top_k: int = 3)

ビリビリのホットランキング動画情報を取得し、最大 top_k 個の項目を返します（上限は 10 件）。

戻り値の例

[
  {
    "title": "“战火啊，能不能在黎明前停歇一次”",
    "link": "https://b23.tv/BV1...z",
    "desc": "喜欢的朋友可以点赞投币关注一下哦，你的支持是我最大的动力！！",
    "view": 1234567,
    "like": 98765
  },
  ...
]

🔧 技術詳細

• httpx を使用して非同期リクエストを実装します。
• FastMCP をベースに標準の MCP ツールとして登録します。
• stdio を介して MCP クライアント（例：Cursor）と通信することをサポートします。

📌 注意事項

⚠️ 重要提示

このツールは学習と研究目的のみで使用してください。ビリビリの API は公開 API ですが、使用時には過度に頻繁なアクセスを避けてください。

💡 使用建议

デフォルトの User-Agent は "qwq" です。必要に応じて、より適切な文字列に変更してください。

📄 ライセンス

MIT License.