get_character_profile

Retrieve detailed character profile information from Wuthering Waves in Markdown format by providing the character's Chinese name.

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:84-102 (handler)

Primary handler function for the 'get_character_profile' MCP tool, registered with @mcp.tool(). Proxies the call to the character service after basic error handling.

@mcp.tool()
async def get_character_profile(character_name: str) -> str:
    """获取库街区上的角色档案信息并以 Markdown 格式返回。

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

    Returns:
        包含角色档案信息的 Markdown 字符串，
        或者在找不到角色或获取数据失败时返回错误消息。
    """
    try:
        character_service, _ = get_services()
        return await character_service.get_character_profile(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/services/character_service.py:108-151 (helper)

Core business logic implementation in CharacterService class. Retrieves raw character data from repository, parses the profile content, generates Markdown output, and handles errors appropriately.

async def get_character_profile(self, character_name: str) -> str:
    """Get character profile information only.

    Args:
        character_name: Name of the character to query.

    Returns:
        Markdown formatted character profile.

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

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

        # Parse profile content
        character_profile_data = await asyncio.to_thread(
            self.content_parser.parse_character_profile, character_raw_data
        )

        # Generate markdown
        profile_markdown = self.markdown_service.generate_character_markdown(
            character_profile_data, include_strategy=False
        )

        if not profile_markdown.strip():
            self.logger.warning(f"Generated empty profile for: {character_name}")
            return f"成功获取 '{character_name}' 的档案数据，但解析后的内容无法生成有效的 Markdown。"

        self.logger.info(f"Successfully generated character profile for: {character_name}")
        return profile_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 profile for {character_name}: {e}")
        raise ServiceException(f"Character profile retrieval failed: {e}")

src/wuwa_mcp_server/core/interfaces.py:94-96 (schema)
Type signature definition in CharacterServiceProtocol interface, defining the expected input (str character_name) and output (str) for the method.
```
async def get_character_profile(self, character_name: str) -> str:
    """Get character profile information."""
    ...
```

WuWa MCP Server