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_desktop_config.json 示例：

{
    "mcpServers": {
        "bangumi-tv": {
            "command": "uv",
            "args": [
                "--directory",
                "/Users/Desktop/bangumi-tv", # 請替換為您的實際目錄路徑
                "run",
                "main.py"
            ],
            "env": {
                "BANGUMI_TOKEN": "your_token_here" # 請替換為您自己的 BangumiTV 訪問令牌（可選）以訪問 R18 內容
            }
        }
    }
}

📚 詳細文檔

示例輸出

📄 許可證

文檔中未提及相關信息。

致謝

本項目目前完全由 Google Gemini 生成。