{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_tzhjp4g6t2zh","handle":"wuwa-mcp","url":"https://wellknown.network/agents/wuwa-mcp","links":{"self":"https://wellknown.network/agents/wuwa-mcp/record.json","html":"https://wellknown.network/agents/wuwa-mcp","markdown":"https://wellknown.network/agents/wuwa-mcp/record.md","api":"https://wellknown.network/api/v1/agents/wuwa-mcp","status":"https://wellknown.network/api/v1/agents/wuwa-mcp/status","claim":"https://wellknown.network/agents/wuwa-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/wuwa-mcp/claim.json","badge":"https://wellknown.network/agents/wuwa-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/wuwa-mcp/history","tools":"https://wellknown.network/api/v1/agents/wuwa-mcp/tools"},"ard":{"identifier":"urn:air::server:wuwa-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"wuwa-mcp","summary":"MCP server that fetches Wuthering Waves character and echo data from the KuroBBS wiki and returns LLM-friendly Markdown.","description":"# 鸣潮 MCP Server\n\n一个 Model Context Protocol (MCP) 服务器，用于获取《鸣潮》游戏的角色与声骸信息，并以 Markdown 格式返回，便于大型语言模型直接消费。\n\n**📄 [English Documentation](README_EN.md) | 🇨🇳 中文文档**\n\n> **本仓库是 [jacksmith3888/wuwa-mcp-server](https://github.com/jacksmith3888/wuwa-mcp-server) 的二次修改版**，\n> 上游停留在 v2.0.1（MIT 许可），当前版本 **v2.2.0**，由 **颗粒** 维护。\n> 改动要点：适配 mcp 2.x、修复攻略子页抓取失败、输出去重、移除长度截断。\n> 完整清单见文末「版本改动」。\n\n## 功能特点\n\n- **角色信息查询**：获取角色详情，含技能、养成攻略\n- **声骸信息查询**：获取声骸套装的详细信息\n- **角色档案查询**：获取角色档案信息\n- **LLM 友好输出**：结果格式为大型语言模型优化，内容去重且不截断\n- **双传输模式**：支持 STDIO 与 Streamable HTTP\n\n## 环境要求\n\n- Python ≥ 3.12\n- [uv](https://docs.astral.sh/uv/)（包管理与运行）\n\n## 安装\n\n### 从 PyPI 安装（推荐）\n\n```bash\n# 装进你的项目\nuv add wuwa-mcp\n\n# 或者不安装，直接运行\nuvx wuwa-mcp\n```\n\n### 从 GitHub 安装\n\n```bash\nuv add \"git+https://github.com/wzkzd666/wuwa-mcp-server\"\n\n# 锁定到某个版本\nuv add \"git+https://github.com/wzkzd666/wuwa-mcp-server@v2.2.0\"\n```\n\n### 从本地源码安装（开发用）\n\n```bash\n# 以路径依赖装进你的项目\nuv add /path/to/wuwa-mcp-server\n\n# 安装到本仓库自身环境\ncd /path/to/wuwa-mcp-server\nuv sync\n\n# 或先构建再安装产物\nuv build\nuv pip install dist/*.whl\n```\n\n> ⚠️ 不要安装 `wuwa-mcp-server` —— PyPI 上那个是上游 v2.0.1，不含 mcp 2.x 适配与去重 / 缓存修复，在 mcp 2.x 环境下启动即崩。\n> 本项目发布的包名是 **`wuwa-mcp`**，import 名与包名一致为 **`wuwa_mcp`**（`import wuwa_mcp`）。\n> 唯一的控制台命令也是 **`wuwa-mcp`**。\n\n### 命名对照\n\n| 用途 | 名称 |\n|---|---|\n| PyPI 分发包名 | `wuwa-mcp` |\n| import 名 | `wuwa_mcp` |\n| 控制台命令 | `wuwa-mcp`（唯一） |\n| MCP 服务器名 | `wuwa-mcp` |\n\n## 使用方法\n\n任何支持 MCP 的客户端（Claude Desktop、Cherry Studio、Cline 等）都可用同一份配置接入。\n\n从 PyPI 安装后，最简配置：\n\n```json\n{\n  \"mcpServers\": {\n    \"wuwa-mcp\": {\n      \"command\": \"uvx\",\n      \"args\": [\"wuwa-mcp\"]\n    }\n  }\n}\n```\n\n从本地源码或路径运行时：\n\n```json\n{\n  \"mcpServers\": {\n    \"wuwa-mcp\": {\n      \"command\": \"uv\",\n      \"args\": [\"--directory\", \"/path/to/wuwa-mcp-server\", \"run\", \"wuwa-mcp\"]\n    }\n  }\n}\n```\n\n### 与 Claude Desktop 一起运行\n\n1. 下载 [Claude Desktop](https://claude.ai/download)\n2. 创建或编辑配置文件：\n   - macOS：`~/Library/Application Support/Claude/claude_desktop_config.json`\n   - Windows：`%APPDATA%\\Claude\\claude_desktop_config.json`\n3. 填入上面的 `mcpSe…","publisher":{"name":"jacksmith3888","url":null},"homepage":null,"repository":"https://github.com/wzkzd666/wuwa-mcp-server/issues","version":"2.2.1","license":null,"protocols":["mcp"],"tags":["mcp","model-context-protocol","wuthering-waves","game-wiki","llm"],"pricing":null,"endpoints":[{"url":"pypi:wuwa-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"productivity.notes","name":"Notes & Docs","confidence":0.967,"provenance":"derived"},{"slug":"code.documentation","name":"Code Documentation","confidence":0.848,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["code","dev","productivity"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"wuwa-mcp","registry":"pypi","observedAt":"2026-09-12T08:20:47.304Z","publishedAt":"2026-09-11T11:59:07.634916Z","latestVersion":"2.2.1"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"wuwa-mcp","url":"https://pypi.org/project/wuwa-mcp/","firstSeenAt":"2026-09-12T08:20:40.727Z","fetchedAt":"2026-09-12T08:20:40.727Z","normalizedAt":"2026-09-12T08:20:40.727Z"}]},"firstSeenAt":"2026-09-12T08:20:40.727Z","updatedAt":"2026-09-12T08:20:47.304Z"}