# 无限图鉴 MCP：接入与使用（写给 AI Agent）

> 用户把这份说明交给你，是想让你接上「无限图鉴」的 MCP 服务器，然后用它回答《魔兽世界：无限》（国服）的问题。网页版：https://wuxianwow.com/ai

## 它是什么

- 无限图鉴（https://wuxianwow.com）是《魔兽世界：无限》国服客户端 1.60.1.70707 的非官方数据图鉴：专业与配方、物品与装备、任务、NPC 与副本、地图与飞行路线、天赋与技能书、客户端版本改动，以及每天采集一次的拍卖行价格。
- MCP 服务器：`https://wuxianwow.com/mcp`，Streamable HTTP、无状态、无需认证，除 report_issue（提交问题）外只读，49 个工具；每个客户端每分钟最多 600 次请求。名称请用 `wuxianwow`。
- 本站为玩家自制的非官方网站，与暴雪娱乐、网易无关；游戏内容版权归暴雪娱乐所有。

## 接入

按你所在的客户端添加这个服务器。改配置文件前先告诉用户你要改哪个文件；有的客户端要重启或刷新才会加载新的服务器，需要时提醒用户。

### Claude Code

- 在终端里运行：`claude mcp add --scope user --transport http wuxianwow https://wuxianwow.com/mcp`
- --scope user 让所有项目都能用，不加只在当前项目里有。
- 确认：运行 claude mcp list，wuxianwow 显示 Connected（会话里输入 /mcp 也能看）就接好了。

### Claude

- 打开 Claude 的连接器设置：https://claude.ai/customize/connectors
- 网页版和桌面版共用一套连接器：Customize → Connectors → Add custom connector。
- 名称填 wuxianwow，URL 填：`https://wuxianwow.com/mcp`
- Authentication 选 No sign-in，点 Add。免费账号只能加 1 个自定义连接器。
- 确认：对话框左下的「+」→ Connectors 里打开 wuxianwow，提问时出现工具调用就接好了。

### Cursor

- 一键添加到 Cursor（用户在浏览器里点）：cursor://anysphere.cursor-deeplink/mcp/install?name=wuxianwow&config=eyJ1cmwiOiJodHRwczovL3d1eGlhbndvdy5jb20vbWNwIn0%3D
- 或者手动写进 ~/.cursor/mcp.json（只给一个项目用就写项目里的 .cursor/mcp.json）：

```
{
  "mcpServers": {
    "wuxianwow": {
      "url": "https://wuxianwow.com/mcp"
    }
  }
}
```

- 确认：侧栏的 Customize（自定义）里能看到 wuxianwow 和它的工具就接好了；出错时在输出面板选 MCP Logs 看日志。

### VS Code

- 一键添加到 VS Code（用户在浏览器里点）：vscode:mcp/install?%7B%22name%22%3A%22wuxianwow%22%2C%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fwuxianwow.com%2Fmcp%22%7D
- 或者在项目里建 .vscode/mcp.json（顶层是 servers，type 不能省）：

```
{
  "servers": {
    "wuxianwow": {
      "type": "http",
      "url": "https://wuxianwow.com/mcp"
    }
  }
}
```

- 在 Copilot 的 Agent 模式里提问。
- 确认：命令面板运行「MCP: 列出服务器」（MCP: List Servers），wuxianwow 在运行就接好了。

### Trae

- 一键添加到 Trae 国内版（用户在浏览器里点）：trae-cn://trae.ai-ide/mcp-import?type=http&name=wuxianwow&config=eyJ1cmwiOiJodHRwczovL3d1eGlhbndvdy5jb20vbWNwIn0%3D
- 国际版（用户在浏览器里点）：trae://trae.ai-ide/mcp-import?type=http&name=wuxianwow&config=eyJ1cmwiOiJodHRwczovL3d1eGlhbndvdy5jb20vbWNwIn0%3D
- 或者：设置 → MCP → 添加 → 手动添加。
- 粘贴后点确认：

```
{
  "mcpServers": {
    "wuxianwow": {
      "url": "https://wuxianwow.com/mcp"
    }
  }
}
```

- 内置的智能体「Agent」会带上所有添加了的服务器；自定义智能体要在「工具 - MCP」里勾上。
- 确认：MCP 列表里出现 wuxianwow 就接好了；有问题点它的齿轮 → 日志。

### WorkBuddy

- 插件 → MCP 服务器 → 配置 MCP。
- 粘贴：

```
{
  "mcpServers": {
    "wuxianwow": {
      "type": "http",
      "url": "https://wuxianwow.com/mcp"
    }
  }
}
```

- 第一次连接要点「信任」，再打开 wuxianwow 的开关。
- 确认：wuxianwow 显示「启用」和已启用的工具数就接好了。

### Cherry Studio

- 一键添加到 Cherry Studio（用户在浏览器里点）：cherrystudio://mcp/install?servers=eyJtY3BTZXJ2ZXJzIjp7Ind1eGlhbndvdyI6eyJ0eXBlIjoic3RyZWFtYWJsZUh0dHAiLCJiYXNlVXJsIjoiaHR0cHM6Ly93dXhpYW53b3cuY29tL21jcCJ9fX0%3D
- 或者：设置 → MCP 服务器 → 添加 → 快速创建，名称填 wuxianwow，类型选「可流式传输的 HTTP（streamableHttp）」，URL 填：`https://wuxianwow.com/mcp`
- 打开服务器开关（问「运行外部 MCP？」时点运行）；对话时在输入框的 MCP 按钮里勾上 wuxianwow。
- 确认：服务器详情的「工具」页列出全部工具就接好了。

### Codex

- 在终端里运行：`codex mcp add wuxianwow --url https://wuxianwow.com/mcp`
- 或者写进 ~/.codex/config.toml：

```
[mcp_servers.wuxianwow]
url = "https://wuxianwow.com/mcp"
```

- 确认：运行 codex mcp list（或在 Codex 里输入 /mcp），列表里有 wuxianwow 就接好了；命令行、IDE 插件和桌面版共用这份配置。

### 其他

- Gemini CLI：`gemini mcp add --scope user --transport http wuxianwow https://wuxianwow.com/mcp`
- Antigravity CLI：写进 ~/.gemini/config/mcp_config.json：

```
{
  "mcpServers": {
    "wuxianwow": {
      "serverUrl": "https://wuxianwow.com/mcp"
    }
  }
}
```

- 只能用命令启动（stdio）的客户端，经 mcp-remote 转接（要 Node 18 以上）：

```
{
  "mcpServers": {
    "wuxianwow": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://wuxianwow.com/mcp"
      ]
    }
  }
}
```

- ChatGPT：chatgpt.com/plugins →「+」→ Add custom MCP server，Connection 填接入地址；哪些套餐能用以 ChatGPT 为准。
- 其他支持网址的客户端一般认这种写法（要求写类型的，再加 "type": "http"）：

```
{
  "mcpServers": {
    "wuxianwow": {
      "url": "https://wuxianwow.com/mcp"
    }
  }
}
```

- 确认：接好后问一句「瑟银锭被哪些配方用到」，回答里出现工具调用就接好了。

## 接好后先试一次

- 调用 `search`，`query` 填「瑟银锭」：应找到物品 12359，网址 https://wuxianwow.com/item/12359。把结果和网址告诉用户。

## 直接用 HTTP 调用

- 不经 MCP 客户端也能调：POST `https://wuxianwow.com/mcp`，请求体是 JSON-RPC 2.0。服务器无状态，不用先 initialize，直接 `tools/list` 或 `tools/call`；返回一律是 JSON。
- 请求头：`Content-Type: application/json`，推荐 `Accept: application/json, text/event-stream`（MCP 规范的写法）；只写 `application/json`、`*/*` 或不写 Accept 也行。只要 HTML 之类的会得到 406。
- 例：`curl -X POST https://wuxianwow.com/mcp -H "Content-Type: application/json" -H "Accept: application/json, text/event-stream" -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"瑟银锭"}}}'`
- 结果里的 `ignored_params` 是这个工具没有的参数（拼错了，或是别的工具的参数），已经忽略；按工具说明改了再调。

## 用法

- 先用 `search` 找配方或物品（中文子串、拼音首字母都行），再用 `fetch` 取详情；任何工具结果里的 `id` 或 `fetch_id` 都能直接交给 `fetch`，`fetch` 也接受本站的完整网址。
- 专题都有自己的工具：专业冲级路线 `leveling_route`、材料反查 `item_usage`、任务 `quests`、副本 `instances`、地图与飞行路线 `atlas`、天赋 `talents`、拍卖行价格 `auction_house`、客户端版本 `builds` / `build_changes` 等；每个工具的说明里写了参数和取值。
- 每条记录的规范地址就是网页地址；回答时附上它，用户点开就是同一份数据。

## 3D 页面（导演台、旅拍）

- 用浏览器截图前先等 `<html data-stage="ready">`：一有改动（点按钮、拖镜头、传送）它就变成 `busy`，载入完、新的一帧画好才变回 `ready`。浏览器很慢（没有显卡、软件渲染）时在链接后加 `&quality=low`；导出与照片不受影响。
- 旅拍拍人像：`trip` 给 `place` 和 `preset`（人像 / 全身 / 环境人像 / 自拍），或 `facing=camera`、`camera`、`focal`、`aspect`、`subject_scale`；子区域与区域落在附近开阔的空地上、朝着那个地方，面向镜头后背后就是它；副本落在门口或里面开阔的地方、朝着副本里。链接也可以自己拼：`/trip?instance=<地图 ID>&mode=landscape&focal=24&aspect=16:9`（`mode` 是 other 他拍 / selfie 自拍 / landscape 风景，旧的 `cam` 照样认；另有 `face`、`size`）。`instances` 的副本资料不全时有 `incomplete_reason`，不能旅拍时有 `trip_unavailable`（原因）。`races` 的 `start_zone` 是各族新手村与它的旅拍链接。导演台的写法见 /director.md。

## 回答时的规矩

- 注明来源「无限图鉴 wuxianwow.com」并附页面链接。
- `temporary` 字段是第三方临时数据（QuestieDB；它没有的任务用 RestedXP 练级指南），转述时注明「临时」；拍卖行价格是游戏里每天采集的挂单，注明采集时间和阵营；`insights` 里的推断与预测是基于客户端数据的推测，不是官方信息。
- 客户端里没有首领掉落；`temporary_drops` 是第三方的临时掉落（Spyglass 整理的《无限》副本掉落，没有它的首领用 QuestieDB 的经典旧世数据；大多没有掉落率），转述时注明「临时」。其他客户端没有的内容工具结果会注明，不要自己补。

## 工具（49 个）

- 通用：`search`（搜索）、`fetch`（按 id 取任意记录）、`topic`（专题页数据）、`stats`（数据规模）、`report_issue`（提交问题）
- 配方与专业：`list_professions`（列出专业）、`list_categories`（列出配方分类）、`recipes`（按条件列配方）、`item_usage`（材料反查）、`profession_guide`（专业技能点指南）、`leveling_route`（专业冲级路线）、`camping`（露营设施）
- 角色：`legacy_tree`（传承树）、`races`（种族、种族天赋与新手村）、`talents`（天赋模拟器）、`spellbook`（职业技能书）、`titles`（称号）、`factions`（声望）、`achievements`（成就）、`sim`（战斗模拟器）
- 装备：`item_sets`（套装）、`gear_items`（装备库）、`epic_items`（史诗装备）、`bundle`（天裔礼包与年卡礼包）
- 世界：`instances`（副本）、`quests`（任务）、`npcs`（NPC 与首领）、`npc_looks`（1.60 新增 NPC 外观）、`atlas`（地图集）
- 客户端版本：`builds`（客户端版本）、`hotfixes`（服务器热修）、`build_changes`（版本改动）、`entity_history`（实体的版本历史）、`insights`（版本洞察）、`predictions`（预测记分板）
- 无限世界书：`lore_search`（无限世界书 · 搜索）、`lore_entity`（无限世界书 · 人物与地点）、`lore_timeline`（无限世界书 · 年表）、`lore_relation`（无限世界书 · 两人之间）、`lore_knows`（无限世界书 · 知道什么）、`lore_conflicts`（无限世界书 · 考据板）、`lore_event`（无限世界书 · 事件）
- 拍卖行：`auction_house`（拍卖行）
- 无限导演台：`stage`（导演台摆位）、`revise`（导演台改演出）、`retell`（导演台换拍法）、`stage_project`（导演台项目）
- 艾泽拉斯旅拍：`trip`（艾泽拉斯旅拍）
- 插件开发：`addon_api`（插件 API 手册）

## 可以这样问

- 练级：「我 38 级联盟战士，接下来去哪练级、能打哪些副本？」——工具 `atlas`、`instances`；网页上 https://wuxianwow.com/instances
- 专业：「锻造 150 了，怎么冲到 225？材料按今天拍卖行的价格要多少钱？」——工具 `leveling_route`、`auction_house`；网页上 https://wuxianwow.com/profession/164#route
- 赶路：「从暴风城飞藏宝海湾，最省钱怎么飞？」——工具 `atlas`；网页上 https://wuxianwow.com/atlas
- 天赋：「给 60 级战士配一套武器天赋，附上模拟器链接。」——工具 `talents`；网页上 https://wuxianwow.com/talents/1
- 拍卖行：「今天拍卖行有什么能低买高卖的？」——工具 `auction_house`；网页上 https://wuxianwow.com/ah/deals
- 版本：「最近几个客户端版本加了什么新东西？」——工具 `builds`、`insights`；网页上 https://wuxianwow.com/builds

## 其他入口

- 工具清单与直接调用（curl）：https://wuxianwow.com/about#mcp
- 站点说明：https://wuxianwow.com/llms.txt；任意页面地址加 `.md` 得到 Markdown、加 `.jsonld` 得到 JSON-LD，例如 https://wuxianwow.com/recipe/11862.md
- 数据文件：https://wuxianwow.com/about#data；版权与免责声明：https://wuxianwow.com/legal