get_character_info

Retrieve detailed character information from Wuthering Waves including skills and cultivation guides in Markdown format for game strategy planning.

Instructions

获取库街区上的角色详细信息包括角色技能，养成攻略等，并以 Markdown 格式返回。

    Args:
        character_name: 要查询的角色的中文名称。

    Returns:
        包含角色信息的 Markdown 字符串，
        或者在找不到角色或获取数据失败时返回错误消息。

Input Schema

TableJSON Schema

Name	Required	Description	Default
`character_name`	Yes

Implementation Reference

src/wuwa_mcp_server/server.py:64-82 (handler)

The primary MCP tool handler for 'get_character_info', registered via @mcp.tool() decorator. It handles input validation implicitly via type hints, calls the character service, and provides error messages.

@mcp.tool()
async def get_character_info(character_name: str) -> str:
    """获取库街区上的角色详细信息包括角色技能，养成攻略等，并以 Markdown 格式返回。

    Args:
        character_name: 要查询的角色的中文名称。

    Returns:
        包含角色信息的 Markdown 字符串，
        或者在找不到角色或获取数据失败时返回错误消息。
    """
    try:
        character_service, _ = get_services()
        return await character_service.get_character_info(character_name)
    except (DataNotFoundException, ServiceException) as e:
        # These exceptions already have user-friendly messages
        return str(e)
    except Exception:
        return f"错误：处理 '{character_name}' 时发生意外错误。请检查服务器日志。"

src/wuwa_mcp_server/core/interfaces.py:90-92 (schema)
Interface protocol defining the expected signature for get_character_info: input character_name (str), output str (markdown). Serves as schema reference.
```
async def get_character_info(self, character_name: str) -> str:
    """Get comprehensive character information."""
    ...
```
src/wuwa_mcp_server/server.py:185-186 (registration)
Manual registration and dispatch for 'get_character_info' tool in the HTTP transport mode endpoint.
```
if tool_name == "get_character_info":
    result = await character_service.get_character_info(arguments.get("character_name"))
```

src/wuwa_mcp_server/services/character_service.py:35-107 (helper)

The CharacterService implementation providing the core business logic for fetching, parsing, and formatting character information into Markdown, including optional strategy content.

async def get_character_info(self, character_name: str) -> str:
    """Get comprehensive character information including strategy.

    Args:
        character_name: Name of the character to query.

    Returns:
        Markdown formatted character information.

    Raises:
        ServiceException: If character retrieval fails.
    """
    try:
        self.logger.info(f"Getting character info for: {character_name}")

        # Get character raw data
        character_raw_data = await self._get_character_data(character_name)

        # Extract strategy item ID for parallel processing
        strategy_item_id = self._extract_strategy_item_id(character_raw_data)

        # Parallel processing: parse profile and fetch strategy
        profile_task = asyncio.create_task(
            asyncio.to_thread(self.content_parser.parse_main_content, character_raw_data)
        )

        strategy_task = None
        if strategy_item_id:
            strategy_task = asyncio.create_task(self._fetch_strategy_content(strategy_item_id))

        # Wait for profile parsing
        character_profile_data = await profile_task

        # Generate markdown for profile
        character_markdown = self.markdown_service.generate_character_markdown(
            character_profile_data, include_strategy=False
        )

        # Process strategy if available
        strategy_markdown = ""
        if strategy_task:
            try:
                strategy_raw_data = await strategy_task
                if strategy_raw_data:
                    strategy_parsed = await asyncio.to_thread(
                        self.content_parser.parse_strategy_content, strategy_raw_data
                    )
                    strategy_markdown = self.markdown_service.generate_strategy_markdown(strategy_parsed)
            except Exception as e:
                self.logger.warning(f"Failed to process strategy content: {e}")

        # Combine results
        combined_markdown = character_markdown
        if strategy_markdown:
            combined_markdown += "\n\n" + strategy_markdown

        # Add strategy link if available
        if strategy_item_id:
            link_markdown = self._generate_strategy_link_markdown(strategy_item_id)
            combined_markdown += "\n\n" + link_markdown

        self.logger.info(f"Successfully generated character info for: {character_name}")
        return combined_markdown

    except DataNotFoundException:
        error_msg = f"Character '{character_name}' not found"
        self.logger.error(error_msg)
        return f"错误：未找到名为 '{character_name}' 的角色。"

    except Exception as e:
        self.logger.error(f"Failed to get character info for {character_name}: {e}")
        raise ServiceException(f"Character info retrieval failed: {e}")

WuWa MCP Server