内容
弗奎斯特 MCP
一个 [模型上下文协议（MCP）](https://modelcontextprotocol.io) 服务器，为 AI 助手提供全面访问埃弗游戏数据的能力。搜索 12 个在线数据库、传说/档案来源和本地游戏数据安装，拥有 **412 个工具**，涵盖法术、物品、NPC、区域、任务、派系、成就、督察、雇佣兵、传说、档案等。
## 功能
- **412** 用于查询埃弗数据
- **多源搜索** — 并行查询 12 个在线 EQ 数据库、传说来源和档案来源
- **本地游戏数据** — 直接从解析 70K+ 法术、1600+ 派系、2700+ AA 能力、800+ 督察任务等
- **深入的法术分析** — 效果、类别、堆叠、职业比较、效率排名、突发/持续 DPS、灵活的多参数查询
- **角色数据** — 种族/职业信息、技能上限、基础属性、AC 减轻、神德拉肯遗产
- **生物百科全书** — 980+ NPC/怪物种族类型，可按名称搜索 **督察系统** — 具有原型/特征/工作的代理，任务具有槽位详情和成功/失败结果
- **区域地图** — 34K+ 感兴趣的点来自 Brewall 地图文件，区域搜索按名称/等级，传送法术查找
-丁差异检测** — 在补丁前快照游戏数据，然后比较后查看更改的内容
- **任务指南** — 史诗任务指南、、耕种指南
## 数据源
### 本地游戏数据
主要数据源，为 386 个工具中的 412 个工具提供支持。服务器直接解析埃弗奎斯特游戏文件，以提供对完整游戏数据库的权威、离线访问：
- **+ 法术** 具有效果、职业、类别、堆叠规则和施法消息
- **1600+ 派系** 具有种族、职业和神祇的起始值
- **2700+ AA 能力** 具有排名、描述和法术相关性
- **800+ 督察任务** 和 300+ 代理，具有特征、工作和槽位要求
- **4200+ 雇佣兵模板** 具有姿态、等级和能力
- **34K+ 地图兴趣点** 来自 Brewall 地图文件
- **980+ 生物/NPC 种族类型** ，550+ 游戏内事件，50+ 传说故事
- **成就系统** ，技能上限，基础属性，AC 减轻表等
数据按需解析并缓存在内存中。不需要外部网络调用。
### 在线数据库、传说和档案
通过网页抓取、MediaWiki API 和有界档案搜索 API 调用搜索外部 EQ 社区数据库和历史传说/档案来源。这些提供任务指南、物品数据库、突袭战利品表、原始传说和社区维护或保留的内容，这些内容在本地游戏文件中不可用。
| 来源 | 专门领域 |
|--------|-----------|
| [Allakhazam](https://everquest.allakhazam.com)在线数据库 — 法术、物品、NPC、区域 |
| [Almar's Guides](https://www.almarsguides.com/eq) | 任务指南、史诗指南、升级 |
| [EQ Traders](https://www.eqtraders.com) | 交易技能配方和指南 |
| [EQInterface](https://www.eqinterface.com) | UI组、地图、解析工具 |
| [EQhttps://eqresource.com 现代扩展内容、| [Fanra'shttps://everquest.fanra.info) | 一般游戏 |
| [Lucy](https://lucy.all.com) | 经典 EQ 法术和物品数据（历史） |
| [RaidLoot](https://raidloot.com/EQ) | 按扩展名的突袭战利品表 |
| [Zliz's Compendium](https://www.zlizeq.com) | 综合 EQ 百科全书 |
| [Official Sony EQ History (Wayback)](https://web.archive.org/web/19990910004532/http://everquest.station.sony.com/e_history.html) | 原 1999 年诺拉斯历史页面 |
| [The Firiona Vie Project Lore](https://fvproject.com/index.php/Category) | 经典埃弗奎斯特传说类别，通过 MediaWiki API |
| [EQArchives](https://search.eqarchives.org/) | 保留的、邮件列表、补丁记录、日志、截图和历史语料库搜索 |
## 安装
```bash
git clone https://github.com/ArtSabintsev/everquest1-mcp.git
cd everquest1-mcp
npm install
npm run build
```
### 本数据（可选）
线访问综合游戏数据，请将 `EQ_GAME_PATH` 环境变量设置为您的埃弗奎斯特安装目录。在 macOS 上使用 CrossOver：
```json
{
"mcpServers": {
"everquest": {
"command": "node",
"args": ["/absolute/path/to/everquest1-mcp/dist/index.js"],
"env": {
"EQ_GAME_PATH": "/path/to/EverQuest"
}
}
}
}
```
如果没有此设置，则仅可使用在线数据库工具。
## 配置
添加到您的 Claude Desktop 配置文件（`~/Library/Application Support/Claude_desktop_config.json` 在 macOS 上）：
```json
{
"m": {
"everquest": {
"command": "node",
" ["/absolute/path/toquest1-mcp/dist"]
}
}
然后重启 Claude Desktop。
## 可用工具（412）
| 类别 | 描述 |
|----------|------|
| [在线搜索/tools-online-search.md) | | 跨 9 个 EQ 数据库的多源搜索 |
| [法术和能力](docs/tools-spells.md 276 | 查询、每类配置文件、效率分析、跨类比较、全局统计 |
| [角色和职业](docs/tools-character-classes.md60 | 种族/职业/神祇信息、技能上限、基础属性 减轻、生物类型 |
| [区域和地图](docs/tools-zones-maps.md) | 14 | 、地图兴趣点、传送网络、升级指南 |
|系和货币](docsactions-currencies.md)18 | 160派系、替代货币、贡品、神祇-派系优化 |
| [成就和 AA](docs/tools-achievements-aas.md) | 16 | 成就查询、AA 能力、类别浏览 |
| [督察](docs/tools-overseer.md) | 10 | 300+、800+ 任务、特征/工作优化 |
| [雇佣兵](docs/tools-mercenaries.md) | 7 | 420 模板、姿态、等级分析、职业协同作用 [物品和效果](docs/tools-items-effects.md) | 8 | 1100物品点击/处理效果系统 |
| [传说、参考和补丁检测](docs/tools-lore-reference.md 35 | 传说故事、扩展、事件、帮助主题、补丁差异检测、FVProject 传说、EQ搜索 |
## 示例查询
配置完成后，您可以向 AI 助手提出以下问题： “法术 Complete什么作用？”
- “给我显示所有 Cleric 复活”
- “巫 65 级有哪些火？”
- “为 En 查找所有具有效果的法术 “如何开始 bard 史1.0 - “70-80升级地点是什么？”
- “告诉我关于 Wolves of the North 派系”
-督察任务可用于掠夺？”
- “在 EQArchives 中搜索 Miragul”
- “阅读 FV传说页面 Innoruuk）”
- “显示拉斯历史”
- “在知识平面附近的银行显示地图位置”
- “ 有哪些 AA 能力？”
- “巫师最节省核弹是什么？”
- “比较巫师和魔术师的突发伤害”
- “哪些法术是 Bard 独有的？”
## 开发
```bash
npm run dev # 构建并运行
npm run build # 仅构建
npm run test 测试
npm start # 运行已构建的版本
```
## 架构
```
src/
├── index.ts # MCP 服务器入口点
├── tools.ts # 工具定义和处理程序（412 个工具）
├── sources/ # 数据源实现
│ ├── base.ts # 共享接口和获取实用程序
│ ├── index.ts # 源聚合
│ ├── localdata.ts # 本地 EQ 游戏文件解析器（+ 行）
│ ├── allakhazam.ts #azam 抓取器 ├── almars.ts # Almar's Guides
│ ├── eqresource.ts # EQResource
│ ├── fanra.ts # Fanra's Wiki（MediaWiki API）
│ ├── eqtraders.ts # EQ Trad│ ├──.ts # Z Compendium ├── luc # Lucy 法术/物品数据库
│ raidloot.ts # RaidLoot 突袭掉落 ├── eqinterface.ts # EQInterface UI 模│ └── histor.ts # 官方 EQ 历史、FVProject 传说、EQArchives
└── tests # 测试套件
└── tools.test.ts
```
## 解析的本地游戏数据文件
当设置 `EQ` 时，服务器按需解析这些游戏文件：
| 文件 | 数据 |
|------|------|
| `spells_us.txt` | 70K+ 法术，具有效果、职业、类别 |
| `spells_us_str.txt` | 法术施放消息 |
| `dbstr_us.txt` | AA 名称、法术描述、派系名称、督察数据、事件、扩展、生物类型（）、起始城市传说等 40+ 种字符串类型 `eqstr_us.txt` | 游戏 UI 字符串、神祇传说 |
|/skillcaps.txt` | 按职业/等级的技能上限数据 |
| `Resources/basedata.txt` | 基础属性进程 |
|/ACMitigation.txt` | AC 减轻表 |
| `Resources/SpellStackingGroups | 法术堆叠规则 |
| `Resources/ZoneNames.txt` | 区域名称和简称 |
| `Resources/Achievements/` | 成就定义、类别、组件 |
| `Resources/Faction/` | 派系数据、类别、起始值 |
| `Resources/OvrMini*` | 督察代理数据、特征、图像 |
| `Resources/OvrQst*` | 督察任务数据、槽位、特征组 |
| `Resources/OvrJobClient.txt` | 督察工作类型 |
| `Resources/bannercategories.txt` | 公会旗帜类别 |
| `Resources/campsitecategories.txt`会营地类别 |
| `Resources/playercustomization | 德拉肯（6 个龙 |
| `maps Brewall/标准文件（34K+ POIs） |
| ` | 75 个官方游戏内帮助主题 HTML 文件 添加新源
1. 在 `src/sources/` 中创建一个新文件，实现 `Source` 接口
2. 从 `src/sources/index.ts` 导出它
3. 为多源搜索添加源数组
4. 可选地在 `src/tools.ts` 中添加源特有的工具
## 许可证
MIT
