🚀 Bangumi TV MCP 服務

這是一個 MCP（機器通信協議）服務，可提供對 BangumiTV API 的訪問權限。藉助該服務，您能夠與 BangumiTV 的數據進行交互，檢索有關動漫、漫畫、音樂、遊戲等方面的信息。

🚀 快速開始

此 MCP 服務允許您與 BangumiTV 的數據進行交互，以下是相關介紹。

示例輸出

✨ 主要特性

本服務提供了豐富的 API 接口，涵蓋條目、章節、角色和人員等多個方面，具體如下：

條目

• /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客戶端為例： URL: https://mcpcn.com/docs/quickstart/user/

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 生成。