MCP Service

Name: MCP Service
Author: Ukenn2112

@Ukenn2112

Repository

About MCP Service

bgm.tv MCP Server

#bangumi #mcp #api-service

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "BangumiMCP": {
      "command": "uv",
      "args": [
        "venv"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is BangumiMCP?

BangumiMCP is 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.

How to use BangumiMCP?

Install with Python 3.10+ and the uv package manager (or pip). Clone the repository, create a virtual environment, install dependencies, then configure the server in Claude Desktop by adding an entry to claude_desktop_config.json with the command uv run main.py. Optionally, set the BANGUMI_TOKEN environment variable for authenticated operations.

Key features of BangumiMCP

55 MCP tools covering all Bangumi API endpoints
3 pre-built workflow prompts for common tasks
1 OpenAPI specification resource for documentation
Modular architecture with clean, maintainable code
Full Python type hints and enum definitions
Async support using httpx for non-blocking calls

Use cases of BangumiMCP

Search for anime by keyword and get an AI summary
Retrieve comprehensive subject information including details, persons, characters, and relations
Identify voice actors for a given character
Manage personal collections and watch lists
Browse and edit subject, character, and person entries

FAQ from BangumiMCP

What is the BANGUMI_TOKEN used for?

The token is optional but required for authenticated operations (collections, personal data), access to R18 content, and write operations (create, update, delete). Get a token at https://next.bgm.tv/demo/access-token.

Can I use BangumiMCP without a token?

Yes, without a token you can use all read-only tools (search, browse, get details) and access public user information. Write operations and private data require authentication.

What are the runtime requirements?

Python 3.10 or higher and the uv package manager (or pip). No other external dependencies are mentioned beyond those installed via the project's setup.

How are the MCP tools organized?

Tools are grouped by domain: subjects & episodes (10), characters (7), persons (7), users (3), collections (11), revisions (8), and indices (9). Each tool corresponds to a specific Bangumi API endpoint.