Bangumi TV

🚀 Bangumi TV MCP Service

This is an MCP (Machine Communication Protocol) service that provides access to the BangumiTV API. It allows you to interact with BangumiTV's data and retrieve information about anime, manga, music, games, etc.

🔍 Example Output

✨ Features

Entries

• /calendar: Daily broadcasts
• /v0/search/subjects: Search for subjects
• /v0/subjects: Browse subjects
• /v0/subjects/{subject_id}: Get subject details
• /v0/subjects/{subject_id}/persons: Get a list of persons related to the subject
• /v0/subjects/{subject_id}/characters: Get a list of characters related to the subject
• /v0/subjects/{subject_id}/subjects: Get a list of related subjects

Episodes

• /v0/episodes: Get a list of episodes
• /v0/episodes/{episode_id}: Get episode details

Characters

• /v0/search/characters: Search for characters
• /v0/characters/{character_id}: Get character details
• /v0/characters/{character_id}/subjects: Get a list of subjects related to the character
• /v0/characters/{character_id}/persons: Get a list of persons related to the character

Persons

• /v0/search/persons: Search for persons
• /v0/persons/{person_id}: Get person details
• /v0/persons/{person_id}/subjects: Get a list of subjects related to the person
• /v0/persons/{person_id}/characters: Get a list of characters related to the person

📦 Installation

# Clone the repository
git clone https://github.com/Ukenn2112/BangumiMCP.git
cd BangumiMCP

# Create and activate a virtual environment
uv venv
source .venv/bin/activate  # For Linux/macOS systems
# Or on Windows systems:
# .venv\Scripts\activate

# Install dependencies
uv add "mcp[cli]" requests

💻 Usage Examples

Basic Usage

URL: https://mcpcn.com/docs/quickstart/user/

Here is an example of the claude_desktop_config.json configuration file:

{
    "mcpServers": {
        "bangumi-tv": {
            "command": "uv",
            "args": [
                "--directory",
                "/Users/Desktop/bangumi-tv", # Replace with your actual path
                "run",
                "main.py"
            ],
            "env": {
                "BANGUMI_TOKEN": "your_token_here" # Replace with your BangumiTV token (optional) if you need to view or search for R18 content
            }
        }
    }
}

🙏 Acknowledgments

This project is currently entirely generated by Google Gemini.