get_subject_details
Retrieve detailed information about a specific subject such as anime, books, or games by providing a subject ID, formatted for easy use and integration.
Instructions
Get details of a specific subject (e.g., anime, book, game).
Args:
subject_id: The ID of the subject.
Returns:
Formatted subject details or an error message.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| subject_id | Yes |
Input Schema (JSON Schema)
{
"properties": {
"subject_id": {
"title": "Subject Id",
"type": "integer"
}
},
"required": [
"subject_id"
],
"title": "get_subject_detailsArguments",
"type": "object"
}
Implementation Reference
- main.py:525-596 (handler)The core handler function for the 'get_subject_details' MCP tool. It is decorated with @mcp.tool(), which handles both definition and registration. Fetches subject details from the Bangumi API endpoint /v0/subjects/{subject_id}, processes the response, handles errors, and formats a detailed text summary including name, type, summary, rating, tags, collection stats, and image URL.@mcp.tool() async def get_subject_details(subject_id: int) -> str: """ Get details of a specific subject (e.g., anime, book, game). Args: subject_id: The ID of the subject. Returns: Formatted subject details or an error message. """ response = await make_bangumi_request( method="GET", path=f"/v0/subjects/{subject_id}" ) error_msg = handle_api_error_response(response) if error_msg: return error_msg # Expecting a dictionary if not isinstance(response, dict): return f"Unexpected API response format for get_subject_details: {response}" subject = response infobox = subject.get("infobox") tags = subject.get("tags") details_text = f"Subject Details (ID: {subject_id}):\n" details_text += f" Name: {subject.get('name')}\n" if subject.get("name_cn"): details_text += f" Chinese Name: {subject.get('name_cn')}\n" try: details_text += f" Type: {SubjectType(subject.get('type')).name if subject.get('type') is not None else 'Unknown Type'}\n" except ValueError: details_text += f" Type: Unknown Type ({subject.get('type')})\n" if subject.get("date"): details_text += f" Date: {subject.get('date')}\n" if subject.get("platform"): details_text += f" Platform: {subject.get('platform')}\n" if subject.get("volumes"): details_text += f" Volumes: {subject.get('volumes')}\n" if subject.get("eps") is not None: # Could be 0 details_text += f" Episodes (Wiki): {subject.get('eps')}\n" if subject.get("total_episodes"): details_text += f" Episodes (DB): {subject.get('total_episodes')}\n" details_text += f" Summary:\n{subject.get('summary')}\n" if subject.get("rating", {}).get("score") is not None: details_text += f" Score: {subject['rating'].get('score')} (Votes: {subject['rating'].get('total')})\n" if subject.get("rating", {}).get("rank") is not None: details_text += f" Rank: {subject['rating'].get('rank')}\n" if tags: tags_list = [f"{t['name']} ({t['count']})" for t in tags] details_text += f" Tags: {', '.join(tags_list)}\n" if infobox: details_text += ( " Infobox: (Details available in raw response, potentially complex)\n" ) if "collection" in subject: # requires auth and user had collected it collection = subject["collection"] details_text += f" Collection (Total Users): Wish: {collection.get('wish',0)}, Collected: {collection.get('collect',0)}, Doing: {collection.get('doing',0)}, On Hold: {collection.get('on_hold',0)}, Dropped: {collection.get('dropped',0)}\n" images = subject.get("images") if images and images.get("large"): details_text += f" Cover Image: {images.get('large')}\n" return details_text
- main.py:525-525 (registration)The @mcp.tool() decorator registers the get_subject_details function as an MCP tool.@mcp.tool()
- main.py:527-535 (schema)The function signature (subject_id: int -> str) and docstring define the input schema (single integer parameter) and output (formatted string). No separate Pydantic or JSON schema; relies on type hints and decorator.""" Get details of a specific subject (e.g., anime, book, game). Args: subject_id: The ID of the subject. Returns: Formatted subject details or an error message. """
- main.py:536-596 (helper)Uses shared helper functions make_bangumi_request to call the API and handle_api_error_response for error handling.response = await make_bangumi_request( method="GET", path=f"/v0/subjects/{subject_id}" ) error_msg = handle_api_error_response(response) if error_msg: return error_msg # Expecting a dictionary if not isinstance(response, dict): return f"Unexpected API response format for get_subject_details: {response}" subject = response infobox = subject.get("infobox") tags = subject.get("tags") details_text = f"Subject Details (ID: {subject_id}):\n" details_text += f" Name: {subject.get('name')}\n" if subject.get("name_cn"): details_text += f" Chinese Name: {subject.get('name_cn')}\n" try: details_text += f" Type: {SubjectType(subject.get('type')).name if subject.get('type') is not None else 'Unknown Type'}\n" except ValueError: details_text += f" Type: Unknown Type ({subject.get('type')})\n" if subject.get("date"): details_text += f" Date: {subject.get('date')}\n" if subject.get("platform"): details_text += f" Platform: {subject.get('platform')}\n" if subject.get("volumes"): details_text += f" Volumes: {subject.get('volumes')}\n" if subject.get("eps") is not None: # Could be 0 details_text += f" Episodes (Wiki): {subject.get('eps')}\n" if subject.get("total_episodes"): details_text += f" Episodes (DB): {subject.get('total_episodes')}\n" details_text += f" Summary:\n{subject.get('summary')}\n" if subject.get("rating", {}).get("score") is not None: details_text += f" Score: {subject['rating'].get('score')} (Votes: {subject['rating'].get('total')})\n" if subject.get("rating", {}).get("rank") is not None: details_text += f" Rank: {subject['rating'].get('rank')}\n" if tags: tags_list = [f"{t['name']} ({t['count']})" for t in tags] details_text += f" Tags: {', '.join(tags_list)}\n" if infobox: details_text += ( " Infobox: (Details available in raw response, potentially complex)\n" ) if "collection" in subject: # requires auth and user had collected it collection = subject["collection"] details_text += f" Collection (Total Users): Wish: {collection.get('wish',0)}, Collected: {collection.get('collect',0)}, Doing: {collection.get('doing',0)}, On Hold: {collection.get('on_hold',0)}, Dropped: {collection.get('dropped',0)}\n" images = subject.get("images") if images and images.get("large"): details_text += f" Cover Image: {images.get('large')}\n" return details_text
- main.py:1361-1369 (helper)A related MCP prompt that instructs usage of get_subject_details along with other tools for full subject info.def get_subject_full_info(subject_id: int) -> str: """ Get detailed information, related persons, characters, and relations for a subject. Args: subject_id: The ID of the subject to get information for. """ return f"Get the full details for subject ID {subject_id} using 'get_subject_details'. Also get related persons using 'get_subject_persons', related characters using 'get_subject_characters', and other related subjects using 'get_subject_relations'. Summarize the key information from all these tool outputs."