Bangumi TVSAFE

English | 中文

English

A Model Context Protocol (MCP) server that provides programmatic access to the Bangumi TV API, enabling AI assistants like Claude to interact with comprehensive anime, manga, music, game, and real-world media data.

Features

• 55 MCP Tools: Complete coverage of Bangumi API endpoints
• 3 Workflow Prompts: Pre-built multi-step workflows for common tasks
• 1 Resource: Full OpenAPI specification for API documentation
• Modular Architecture: Clean, maintainable codebase following MCP best practices
• Type-Safe: Full Python type hints and enum definitions
• Async Support: Non-blocking API calls using httpx

Quick Start

Prerequisites

• Python 3.10 or higher
• uv package manager (recommended) or pip

Installation

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

# Create and activate virtual environment
uv venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
uv pip install -e .

Configuration for Claude Desktop

Add to your claude_desktop_config.json:

{
"mcpServers": {
"bangumi-tv": {
"command": "uv",
"args": [
"--directory",
"/path/to/BangumiMCP",
"run",
"main.py"
],
"env": {
"BANGUMI_TOKEN": "your_token_here"
}
}
}
}

Note: BANGUMI_TOKEN is optional but required for:

• Authenticated operations (collections, personal data)
• R18 content access
• Write operations (create, update, delete)

Get your token at: https://next.bgm.tv/demo/access-token

Project Architecture

BangumiMCP follows a modular architecture designed for maintainability and scalability:

BangumiMCP/
├── main.py                           # Server initialization (44 lines)
├── src/
│   ├── config.py                     # Configuration cons