wuwa-mcp

# 鸣潮 MCP Server 一个 Model Context Protocol (MCP) 服务器，用于获取《鸣潮》游戏的角色与声骸信息，并以 Markdown 格式返回，便于大型语言模型直接消费。 **📄 [English Documentation](README_EN.md) | 🇨🇳 中文文档** > **本仓库是 [jacksmith3888/wuwa-mcp-server](https://github.com/jacksmith3888/wuwa-mcp-server) 的二次修改版**， > 上游停留在 v2.0.1（MIT 许可），当前版本 **v2.2.0**，由 **颗粒** 维护。 > 改动要点：适配 mcp 2.x、修复攻略子页抓取失败、输出去重、移除长度截断。 > 完整清单见文末「版本改动」。 ## 功能特点 - **角色信息查询**：获取角色详情，含技能、养成攻略 - **声骸信息查询**：获取声骸套装的详细信息 - **角色档案查询**：获取角色档案信息 - **LLM 友好输出**：结果格式为大型语言模型优化，内容去重且不截断 - **双传输模式**：支持 STDIO 与 Streamable HTTP ## 环境要求 - Python ≥ 3.12 - [uv](https://docs.astral.sh/uv/)（包管理与运行） ## 安装 ### 从 PyPI 安装（推荐） ```bash # 装进你的项目 uv add wuwa-mcp # 或者不安装，直接运行 uvx wuwa-mcp ``` ### 从 GitHub 安装 ```bash uv add "git+https://github.com/wzkzd666/wuwa-mcp-server" # 锁定到某个版本 uv add "git+https://github.com/wzkzd666/wuwa-mcp-server@v2.2.0" ``` ### 从本地源码安装（开发用） ```bash # 以路径依赖装进你的项目 uv add /path/to/wuwa-mcp-server # 安装到本仓库自身环境 cd /path/to/wuwa-mcp-server uv sync # 或先构建再安装产物 uv build uv pip install dist/*.whl ``` > ⚠️ 不要安装 `wuwa-mcp-server` —— PyPI 上那个是上游 v2.0.1，不含 mcp 2.x 适配与去重 / 缓存修复，在 mcp 2.x 环境下启动即崩。 > 本项目发布的包名是 **`wuwa-mcp`**，import 名与包名一致为 **`wuwa_mcp`**（`import wuwa_mcp`）。 > 唯一的控制台命令也是 **`wuwa-mcp`**。 ### 命名对照 | 用途 | 名称 | |---|---| | PyPI 分发包名 | `wuwa-mcp` | | import 名 | `wuwa_mcp` | | 控制台命令 | `wuwa-mcp`（唯一） | | MCP 服务器名 | `wuwa-mcp` | ## 使用方法 任何支持 MCP 的客户端（Claude Desktop、Cherry Studio、Cline 等）都可用同一份配置接入。 从 PyPI 安装后，最简配置： ```json { "mcpServers": { "wuwa-mcp": { "command": "uvx", "args": ["wuwa-mcp"] } } } ``` 从本地源码或路径运行时： ```json { "mcpServers": { "wuwa-mcp": { "command": "uv", "args": ["--directory", "/path/to/wuwa-mcp-server", "run", "wuwa-mcp"] } } } ``` ### 与 Claude Desktop 一起运行 1. 下载 [Claude Desktop](https://claude.ai/download) 2. 创建或编辑配置文件： - macOS：`~/Library/Application Support/Claude/claude_desktop_config.json` - Windows：`%APPDATA%\Claude\claude_desktop_config.json` 3. 填入上面的 `mcpSe…