WuWa MCP Server

Instructions

    Args:
        artifact_name: 要查询的声骸套装的中文名称。

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

Implementation Reference

• src/wuwa_mcp_server/server.py:44-63 (handler)

  MCP tool registration and primary handler for 'get_artifact_info'. This is the entry point for tool execution in FastMCP, which delegates to the artifact service.

  @mcp.tool()
  async def get_artifact_info(artifact_name: str) -> str:
      """获取库街区上的声骸详细信息并以 Markdown 格式返回。
  
      Args:
          artifact_name: 要查询的声骸套装的中文名称。
  
      Returns:
          包含声骸信息的 Markdown 字符串，
          或者在找不到声骸或获取数据失败时返回错误消息。
      """
      try:
          _, artifact_service = get_services()
          return await artifact_service.get_artifact_info(artifact_name)
      except (DataNotFoundException, ServiceException) as e:
          # These exceptions already have user-friendly messages
          return str(e)
      except Exception:
          return f"错误：处理 '{artifact_name}' 时发生意外错误。请检查服务器日志。"

• src/wuwa_mcp_server/services/artifact_service.py:34-75 (handler)

  Core business logic implementation of get_artifact_info in ArtifactService. Retrieves data from repository, parses content, generates Markdown, and handles errors.

  async def get_artifact_info(self, artifact_name: str) -> str:
      """Get comprehensive artifact information.
  
      Args:
          artifact_name: Name of the artifact set to query.
  
      Returns:
          Markdown formatted artifact information.
  
      Raises:
          ServiceException: If artifact retrieval fails.
      """
      try:
          self.logger.info(f"Getting artifact info for: {artifact_name}")
  
          # Get artifact raw data
          artifact_raw_data = await self._get_artifact_data(artifact_name)
  
          # Parse artifact content
          artifact_parsed_data = await asyncio.to_thread(
              self.content_parser.parse_artifact_content, artifact_raw_data
          )
  
          # Generate markdown
          artifact_markdown = self.markdown_service.generate_artifact_markdown(artifact_parsed_data)
  
          if not artifact_markdown.strip():
              self.logger.warning(f"Generated empty artifact info for: {artifact_name}")
              return f"成功获取 '{artifact_name}' 的声骸数据，但解析后的内容无法生成有效的 Markdown。"
  
          self.logger.info(f"Successfully generated artifact info for: {artifact_name}")
          return artifact_markdown
  
      except DataNotFoundException:
          error_msg = f"Artifact set '{artifact_name}' not found"
          self.logger.error(error_msg)
          return f"错误：未找到名为 '{artifact_name}' 的声骸套装。"
  
      except Exception as e:
          self.logger.error(f"Failed to get artifact info for {artifact_name}: {e}")
          raise ServiceException(f"Artifact info retrieval failed: {e}")

• src/wuwa_mcp_server/core/interfaces.py:99-105 (schema)

  Type protocol/interface definition specifying the signature for get_artifact_info method.

  class ArtifactServiceProtocol(ServiceProtocol):
      """Protocol for artifact service."""
  
      async def get_artifact_info(self, artifact_name: str) -> str:
          """Get artifact information."""
          ...

• src/wuwa_mcp_server/server.py:187-188 (registration)

  Secondary tool dispatch/registration in HTTP transport mode handler.

  elif tool_name == "get_artifact_info":
      result = await artifact_service.get_artifact_info(arguments.get("artifact_name"))