鸣潮 MCP Server provides game data access for Wuthering Waves (WuWa), a popular open-world action RPG. It fetches character information, echo sets, lore, and strategy guides from the Kujiequ community platform. Key features: - Character information queries including stats, abilities, and build recommendations - Echo set (artifact) data retrieval with detailed set effects and farming locations - Character profile and background story access for lore exploration - LLM-optimized Markdown output for easy integration with AI assistants - Dual transport support for both STDIO and Streamable HTTP modes - Cloud deployment ready for VPS, Google Cloud Run, and AWS Lambda environments

鸣潮 MCP Server

[](https://mseep.ai/app/jacksmith3888-wuwa-mcp-server)

[](https://smithery.ai/server/@jacksmith3888/wuwa-mcp-server)

一个 Model Context Protocol (MCP) 服务器，用于获取《鸣潮》游戏的角色和声骸信息，并以 Markdown 格式返回，方便大型语言模型使用。

📄 English Documentation | 🇨🇳 中文文档

🚀 最新更新 (v2.0.1)

功能特点

安装方法

通过 Smithery 安装

要通过 Smithery 自动安装 WuWa MCP Server：

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

通过 uv 安装

直接从 PyPI 安装：

uv pip install wuwa-mcp-server

使用方法

与 Cherry Studio 一起运行

1. 下载 Cherry Studio 2. 在设置中点击 MCP 服务器

添加以下配置：

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

与 Claude Desktop 一起运行

1. 下载 Claude Desktop 2. 创建或编辑您的 Claude Desktop 配置文件： - macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - Windows: %APPDATA%\\Claude\\claude_desktop_config.json

添加以下配置：

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

3. 重启 Claude Desktop

可用工具

1. 角色信息工具

async def get_character_info(character_name: str) -> str

在库街区上查询角色详细信息并以 Markdown 格式返回。

参数：

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

2. 声骸信息工具

async def get_artifact_info(artifact_name: str) -> str

在库街区上查询声骸详细信息并以 Markdown 格式返回。

参数：

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

3. 角色档案工具

async def get_character_profile(character_name: str) -> str

在库街区上查询角色档案信息并以 Markdown 格式返回。

参数：

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

开发和测试

本地运行

# STDIO 模式（默认）
uv run python -m wuwa_mcp_server.server
HTTP 模式
TRANSPORT=http uv run python -m wuwa_mcp_server.server

代码质量

项目使用 ruff 进行代码格式化和静态分析，确保代码质量和一致性。

#### 安装开发依赖

uv sync --extra dev

#### 代码格式化和检查

# 格式化所有 Python 代码
uv run ruff format .
检查代码问题
uv run ruff check .
自动修复可修复的问题
uv run ruff check --fix .

#### Ruff 配置

项目配置了以下代码质量规则：

Docker 部署

# 构建镜像
docker build -t wuwa-mcp-server .
运行容器（HTTP 模式）
docker run -p 8081:8000 wuwa-mcp-server
运行容器（STDIO 模式）
docker run -e TRANSPORT=stdio wuwa-mcp-server

详细功能

结果处理

传输模式

贡献

欢迎提出问题和拉取请求！一些潜在的改进领域：

许可证

本项目采用 MIT 许可证。