内容
# 公会战争重制版 MCP
**公会战争重制版** （2025年公会战争1的重制版）的只读模型上下文协议服务器，适用于公共来源和选择加入的本地安装库存。涵盖预言、派系、夜fall和北方的眼。
## 来源
- 公会战争维基：`https://wiki.guildwars.com/api.php`
- PvXwiki：`https://gwpvx.fandom.com/api.php`
- GW1 构建：`https://gw1builds.com/api/builds`
- YouTube 公共 RSS 源，适用于官方和创作者频道
- r/公会战争 公共 Atom 搜索
- 本地公会战争安装或 VMware Fusion 包元数据，仅在提供明确根目录时
## 安装
这是一个通过 GitHub 分发的标准输入/输出 MCP 服务器。 将 `<owner>` 替换为托管此存储库的 GitHub 所有者或组织。
### Codex
```bash
codex mcp add guildwars-reforged -- npx -y github:<owner>/guildwars-reforged-mcp
codex mcp list
```
选择加入本地库存：
```bash
codex mcp add guildwars-reforged \
--env GW1_LOCAL_ROOTS="/path/to/Guild Wars/or VM.vmwarevm" \
-- npx -y github:<owner>/guildwars-reforged-mcp
```
### Claude 代码
```bash
claude mcp add --scope user guildwars-reforged -- npx -y github:<owner>/guildwars-reforged-mcp
claude mcp list
```
选择加入本地库存：
```bash
claude mcp add --scope user guildwars-reforged \
-e GW1_LOCAL_ROOTS="/path/to/Guild Wars/or VM.vmwarevm" \
-- npx -y github:<owner>/guildwars-reforged-mcp
```
### Claude 桌面版
将此内容合并到 `~/Library/Application Support/Claude/claude_desktop_config.json` 中：
```json
{
"mcpServers": {
"guildwars-reforged": {
"command": "npx",
"args": ["-y", "github:<owner>/guildwars-reforged-mcp"]
}
}
}
```
选择加入本地库存：
```json
{
"mcpServers": {
"guildwars-reforged": {
"command": "npx",
"args": ["-y", "github:<owner>/guildwars-reforged-mcp"],
"env": {
"GW1_LOCAL_ROOTS": "/path/to/Guild Wars/or VM.vmwarevm"
}
}
}
}
```
更改文件后重启 Claude 桌面版。
### Grok
```bash
grok mcp add --scope user guildwars-reforged -- npx -y github:<owner>/guildwars-reforged-mcp
grok mcp list
grok mcp doctor
```
选择加入本地库存：
```bash
grok mcp add --scope user guildwars-reforged \
-e GW1_LOCAL_ROOTS="/path/to/Guild Wars/or VM.vmwarevm" \
-- npx -y github:<owner>/guildwars-reforged-mcp
```
添加服务器后启动新的 Codex、Claude 或 Grok 会话。 现有会话可能无法获取新配置的 MCP 服务器。
从检出：
```bash
npm install
npm run build
node dist/index.js
```
## 工具
- `gw1_sources` - 列出已配置的公共和本地源曲面。
- `gw1_wiki_search` - 搜索公会战争维基、PvXwiki 或两者。
- `gw1_wiki_page` - 获取具有提取的文本、链接、类别和修订元数据的维基页面。
- `gw1_wiki_recent_changes` - 从维基源读取最近的公共更改。
- `gw1_game_updates` - 解析公会战争维基中的最近公会战争游戏更新部分。
- `gw1_builds_search` - 搜索 GW1 构建公共 API 和/或 PvXwiki。
- `gw1_template_code_analyze` - 验证、解码和合法性检查公会战争模板/构建代码（职业、属性、技能名称、构建规则）。
- `gw1_template_encode` - 从职业、属性和技能名称构建可导入的模板代码，并附带合法性报告（一个精英，三个仅限 PvE 的最大值，单一忠诚度，200 属性点预算）。
- `gw1_subreddit_search` - 搜索 r/公会战争公共 Atom 结果。
- `gw1_youtube_sources` - 列出精选的官方和创作者 YouTube 源。
- `gw1_youtube_videos` - 从精选源获取最近的公共 YouTube 视频。
- `gw1_content_search` - 跨维基、PvXwiki、GW1 构建、YouTube 和 r/公会战争搜索。
- `gw1_local_inventory` - 扫描明确的本地根目录以获取公会战争或 VMware Fusion 元数据。
## 资源
- `gw1://sources` - 公共源注册表。
- `gw1://wiki-sources` - 媒体wiki 源注册表。
- `gw1://youtube-sources` - 官方和创作者 YouTube 源注册表。
## 更新管道
大多数内容在工具调用时从公共 API 和源动态获取，因此服务器在提交之间不会过时。 三个计划的工作流程通过以下方式保持其余内容更新：
- `源烟雾测试`（周二/周五）针对每个公共源曲面运行实时检查。 它不会提交任何内容；它会捕获死亡源、API 形状变化和源损坏。
- `刷新技能索引`（周一）从公会战争维基重新提取捆绑的技能索引，并且仅在提取的数据实际更改时提交。 由于安装程序将 `github:<owner>/guildwars-reforged-mcp` 解析为默认分支，因此刷新会在用户无需发布的情况下到达用户。
- `保持活动`（周三）如果存储库在 45 天内保持静默，则进行空提交，以便 GitHub 的 60 天不活动规则不会禁用上述计划。
仅当人类推送到 `main` 时才会进行发布。 数据刷新通常是 3000 个技能字段中的一两个纠正字段，因此不值得拥有自己的版本。
## 本地库存
本地库存是选择加入的。 服务器永远不会扫描默认位置、主目录、VMware 文件夹或游戏安装程序。
使用明确的根目录：
```bash
GW1_LOCAL_ROOTS="/path/to/Guild Wars:/path/to/Some VM.vmwarevm" guildwars-reforged-mcp
```
或将根目录传递给 `gw1_local_inventory` 工具。
扫描程序可以检测：
- `Gw.exe`
- 仅 `Gw.dat` 元数据
- `.txt` 文件中的 `Templates` 文件夹和合理的模板代码
- `.vmwarevm`、`.vmx` 和 `.vmdk` 元数据
它不安装虚拟磁盘，不解析 `Gw.dat`，不跟随符号链接跳出，或写入扫描输出。 默认情况下路径会被编辑，除非调用者明确选择退出。
## 开发
```bash
npm install
npm run typecheck
npm test
npm run build
npm run smoke:sources
```
## 注意事项
本项目与 ArenaNet、NCSoft、公会战争维基、PvXwiki、GW1 构建、Reddit 或 VMware 无关。 它获取公共的、只读的数据，并返回源 URL，以便代理可以将声明归因于原始源。
