Bangumimcp

🚀 Bangumi TV MCP Service

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

🚀 Quick Start

This MCP service allows you to interact with BangumiTV's data. You can use the provided API endpoints to query various information.

✨ Features

Subjects

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

Episodes

• /v0/episodes: Get the episode list.
• /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 the list of subjects related to the character.
• /v0/characters/{character_id}/persons: Get the 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 the list of subjects related to the person.
• /v0/persons/{person_id}/characters: Get the 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
# Or on Windows:
# .venv\Scripts\activate

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

💻 Usage Examples

Basic Usage

Configuration file claude_desktop_config.json example:

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

📚 Documentation

Example Output

📄 License

No license information provided in the original README.

👏 Acknowledgments

This project is currently fully generated by Google Gemini.