wuwa mcp server

Local 2025-09-01 00:59:45 0
search @jacksmith3888/wuwa-mcp-server

A MCP server providing information on Wuthering Waves characters, team compositions, Echoes, and guides
Data sourced from community.

smithery badge

A Model Context Protocol (MCP) server for retrieving character and echo information from the game Wuthering Waves and returning it in Markdown format, optimized for use by large language models.

Features

  • Character Information Query: Retrieve detailed information about characters in Wuthering Waves
  • Echo Information Query: Retrieve detailed information about echo sets in Wuthering Waves
  • Character Profile Query: Retrieve profile information about characters in Wuthering Waves
  • LLM-Friendly Output: Results are formatted specifically for optimization with large language models

Installation Methods

Install via Smithery

To automatically install WuWa MCP Server via Smithery:

npx -y @smithery/cli@latest install @jacksmith3888/wuwa-mcp-server --client claude --key YOUR_SMITHERY_KEYs

Install via uv

Install directly from PyPI:

uv pip install wuwa-mcp-server

Usage

Running with Cherry Studio

  1. Download Cherry Studio
  2. Click on MCP Server in the settings

Add the following configuration:

{
  "mcpServers": {
    "wuwa-mcp": {
      "command": "uvx",
      "args": ["wuwa-mcp-server"]
    }
  }
}

Running with Claude Desktop

  1. Download Claude Desktop
  2. Create or edit your Claude Desktop configuration file:
  3. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  4. Windows: %APPDATA%Claudeclaude_desktop_config.json

Add the following configuration:

{
  "mcpServers": {
    "wuwa-mcp": {
      "command": "uvx",
      "args": ["wuwa-mcp-server"]
    }
  }
}
  1. Restart Claude Desktop

Available Tools

1. Character Information Tool

async def get_character_info(character_name: str) -> str

Queries detailed character information on the database block and returns it in Markdown format.

Parameters:

  • character_name: The Chinese name of the character to query

Returns: A Markdown string containing the character information, or an error message if the character is not found or data retrieval fails.

2. Echo Information Tool

async def get_artifact_info(artifact_name: str) -> str

Queries detailed echo information on the database block and returns it in Markdown format.

Parameters:

  • artifact_name: The Chinese name of the echo set to query

Returns: A Markdown string containing the echo information, or an error message if the echo is not found or data retrieval fails.

3. Character Profile Tool

async def get_character_profile(character_name: str) -> str

Queries character profile information on the database block and returns it in Markdown format.

Parameters:

  • character_name: The Chinese name of the character to query

Returns: A Markdown string containing the character profile information, or an error message if the character is not found or data retrieval fails.

Detailed Features

Result Processing

  • Cleans and formats database block data
  • Optimizes format for LLM consumption

Contribution

Issues and pull requests are welcome! Some potential areas for improvement:

  • Add support for more Wuthering Waves game content
  • Enhance content parsing options
  • Add a caching layer for frequently accessed content

License

This project is licensed under the MIT License.

[
  {
    "description": "获取库街区上的声骸详细信息并以 Markdown 格式返回。nnArgs:n    artifact_name: 要查询的声骸套装的中文名称。nnReturns:n    包含声骸信息的 Markdown 字符串，n    或者在找不到声骸或获取数据失败时返回错误消息。n",
    "inputSchema": {
      "properties": {
        "artifact_name": {
          "title": "Artifact Name",
          "type": "string"
        }
      },
      "required": [
        "artifact_name"
      ],
      "title": "get_artifact_infoArguments",
      "type": "object"
    },
    "name": "get_artifact_info"
  },
  {
    "description": "获取库街区上的角色详细信息包括角色技能，养成攻略等，并以 Markdown 格式返回。nnArgs:n    character_name: 要查询的角色的中文名称。nnReturns:n    包含角色信息的 Markdown 字符串，n    或者在找不到角色或获取数据失败时返回错误消息。n",
    "inputSchema": {
      "properties": {
        "character_name": {
          "title": "Character Name",
          "type": "string"
        }
      },
      "required": [
        "character_name"
      ],
      "title": "get_character_infoArguments",
      "type": "object"
    },
    "name": "get_character_info"
  },
  {
    "description": "获取库街区上的角色档案信息并以 Markdown 格式返回。nnArgs:n    character_name: 要查询的角色的中文名称。nnReturns:n    包含角色档案信息的 Markdown 字符串，n    或者在找不到角色或获取数据失败时返回错误消息。n",
    "inputSchema": {
      "properties": {
        "character_name": {
          "title": "Character Name",
          "type": "string"
        }
      },
      "required": [
        "character_name"
      ],
      "title": "get_character_profileArguments",
      "type": "object"
    },
    "name": "get_character_profile"
  }
]