鸣潮 MCP Server
About
Retrieves character and artifact information from the game Wuthering Waves (鸣潮) as Markdown, optimized for large language models.
Details
- Author
- jacksmith3888
- GitHub stars
- 4
- Downloads
- 195
- Categories
- Search, Other
Jump to
- 查询《鸣潮》角色详细信息（中文名称）
- 查询《鸣潮》声骸套装详细信息（中文名称）
- 查询角色档案信息
- 结果以 Markdown 格式输出，优化 LLM 消费
- 支持 STDIO 和 Streamable HTTP 双传输模式
- 采用领域驱动设计（DDD）架构，代码质量高
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
鸣潮 MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
用户可通过 Smithery 自动安装，或使用 uv pip install wuwa-mcp-server 安装。配置 MCP 客户端（如 Claude Desktop 或 Cherry Studio）时，添加命令 uvx wuwa-mcp-server 即可。服务器支持 STDIO 和 Streamable HTTP 两种传输模式，可通过环境变量 TRANSPORT 切换。
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"\u9e23\u6f6e mcp server": {
"wuwa-mcp": {
"command": "uvx",
"args": [
"wuwa-mcp-server"
]
}
}
}
}McpServers
{
"wuwa-mcp": {
"command": "uvx",
"args": [
"wuwa-mcp-server"
]
}
}鸣潮 MCP Server
一个 Model Context Protocol (MCP) 服务器，用于获取《鸣潮》游戏的角色和声骸信息，并以 Markdown 格式返回，方便大型语言模型使用。
📄 English Documentation | 🇨🇳 中文文档
🚀 最新更新 (v2.0.1)
- 🏗️ 架构重构：采用领域驱动设计（DDD）架构，清晰的分层结构
- 🔧 代码质量：集成 ruff 代码格式化和静态分析工具
- 📝 现代化语法：使用 Python 3.12+ 现代类型注解 (dict/list 替代 Dict/List)
- 🧹 代码清理：移除旧有代码，统一代码风格和质量标准
- ✅ 支持 Streamable HTTP 传输：支持 Smithery 的新 HTTP 传输协议
- 🔄 向后兼容：同时支持传统的 STDIO 和新的 HTTP 传输模式
- 🌐 云端部署就绪：完美适配 VPS、Google Cloud Run、AWS Lambda 等云环境
- 📦 依赖注入：使用依赖注入容器管理服务实例
- 🐳 Docker 优化：使用 uv 的多阶段构建，提升构建速度并减小镜像体积
功能特点
- 角色信息查询：获取《鸣潮》游戏中角色的详细信息
- 声骸信息查询：获取《鸣潮》游戏中声骸套装的详细信息
- 角色档案查询：获取《鸣潮》游戏中角色的档案信息
- LLM 友好输出：结果格式特别为大型语言模型优化
- 双传输模式：支持 STDIO 和 Streamable HTTP 传输
安装方法
通过 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 格式返回。
参数：
- character_name: 要查询的角色的中文名称
返回：
包含角色信息的 Markdown 字符串，或者在找不到角色或获取数据失败时返回错误消息。
2. 声骸信息工具
async def get_artifact_info(artifact_name: str) -> str
在库街区上查询声骸详细信息并以 Markdown 格式返回。
参数：
- artifact_name: 要查询的声骸套装的中文名称
返回：
包含声骸信息的 Markdown 字符串，或者在找不到声骸或获取数据失败时返回错误消息。
3. 角色档案工具
async def get_character_profile(character_name: str) -> str
在库街区上查询角色档案信息并以 Markdown 格式返回。
参数：
- character_name: 要查询的角色的中文名称
返回：
包含角色档案信息的 Markdown 字符串，或者在找不到角色或获取数据失败时返回错误消息。
开发和测试
本地运行
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
