Bangumimcp

🚀 Bangumi TV MCP サービス

このサービスは、BangumiTV API へのアクセスを提供する MCP（機械通信プロトコル）サービスです。BangumiTV のデータとやり取りし、アニメ、漫画、音楽、ゲームなどに関する情報を取得できます。

🚀 クイックスタート

このサービスを使用することで、BangumiTV のデータにアクセスし、様々な情報を取得できます。以下に具体的な機能や使い方を説明します。

✨ 主な機能

エントリー

• /calendar 毎日の放送予定を照会
• /v0/search/subjects 主題を検索
• /v0/subjects 主題リストを閲覧
• /v0/subjects/{subject_id} 主題の詳細を取得
• /v0/subjects/{subject_id}/persons 主題に関連する人物リストを取得
• /v0/subjects/{subject_id}/characters 主題に関連するキャラクターリストを取得
• /v0/subjects/{subject_id}/subjects 関連する主題リストを取得

エピソード

• /v0/episodes エピソードリストを取得
• /v0/episodes/{episode_id} エピソードの詳細を取得

キャラクター

• /v0/search/characters キャラクターを検索
• /v0/characters/{character_id} キャラクターの詳細を取得
• /v0/characters/{character_id}/subjects キャラクターに関連する主題リストを取得
• /v0/characters/{character_id}/persons キャラクターに関連する人物リストを取得

人物

• /v0/search/persons 人物を検索
• /v0/persons/{person_id} 人物の詳細を取得
• /v0/persons/{person_id}/subjects 人物に関連する主題リストを取得
• /v0/persons/{person_id}/characters 人物に関連するキャラクターリストを取得

📦 インストール

# リポジトリをクローン
git clone https://github.com/Ukenn2112/BangumiMCP.git
cd BangumiMCP

# 仮想環境を作成してアクティブ化
uv venv
source .venv/bin/activate  # Linux/macOS 用
# または Windows では:
# .venv\Scripts\activate

# 依存関係をインストール
uv add "mcp[cli]" requests

💻 使用例

基本的な使用法

Claude クライアントでの使用

設定ファイル claude_desktop_config.json の例：

{
    "mcpServers": {
        "bangumi-tv": {
            "command": "uv",
            "args": [
                "--directory",
                "/Users/Desktop/bangumi-tv", # 実際のディレクトリパスに置き換えてください
                "run",
                "main.py"
            ],
            "env": {
                "BANGUMI_TOKEN": "your_token_here" # R18 コンテンツにアクセスする場合は、自分の BangumiTV アクセストークンに置き換えてください（オプション）
            }
        }
    }
}

🔍 出力例

📄 謝辞

このプロジェクトは現在、完全に Google Gemini によって生成されています。