Monster Hunter World Helper MCP Server

Monster Hunter World Helper MCP 服务

一个 MCP（Model Context Protocol）服务，可通过 MHW DB API 提供工具和资源，用于访问 Monster Hunter World 游戏数据。

功能

资源

• monster://{id} - 获取特定怪物的详细信息
• armor-set://{id} - 获取特定防具套装的详细信息

工具

• find-monster - 按名称搜索怪物，并获取其弱点、所在地和种族等详细信息
• find-weapon-path - 获取武器完整的锻造路径，包括所有所需材料
• find-armor-by-skill - 搜索具有特定技能的防具部件

提示词

• monster-guide - 获取特定怪物的全面狩猎指南
• farming-guide - 获取特定物品的高效刷取策略
• build-planner - 根据武器类型和玩法风格获取配装建议

安装

1. 克隆仓库
2. 安装依赖：

npm install

3. 启动服务：

npm run dev

服务将以 stdio 模式启动，并在存在 .roo/mcp.json 配置时自动连接到 Roo。

使用示例

查找怪物信息

// Example tool usage through Roo
const result = await tool.use("find-monster", { name: "Rathalos" });

响应将包括：

• 怪物名称和类型
• 种族信息
• 可找到该怪物的地点
• 属性／异常状态弱点
• 描述

获取武器锻造路径

// Example tool usage through Roo
const result = await tool.use("find-weapon-path", {
  name: "Defender Greatsword",
});

响应将包括：

• 完整的升级路径
• 每个步骤所需的材料
• 材料来源／描述

按技能查找防具

// Example tool usage through Roo
const result = await tool.use("find-armor-by-skill", { skill: "Attack Boost" });

响应将包括：

• 符合条件的防具部件列表
• 防具属性和稀有度
• 技能等级
• 锻造所需材料

获取怪物狩猎指南

// Example prompt usage through Roo
const result = await prompt.use("monster-guide", { monster: "Nergigante" });

响应将提供：

1. 弱点和抗性
2. 推荐的武器／属性
3. 建议携带的重要物品
4. 需要留意的关键机制
5. 推荐的防具技能

API 详情

资源端点

怪物资源（monster://{id}）

从 MHW DB API 返回怪物的详细信息。

防具套装资源（armor-set://{id}）

从 MHW DB API 返回防具套装的详细信息。

工具参数

find-monster

• name（string）：要搜索的完整或部分怪物名称

find-weapon-path

• name（string）：要搜索的完整或部分武器名称

find-armor-by-skill

• skill（string）：要搜索的完整或部分技能名称

提示词参数

monster-guide

• monster（string）：要获取指南的怪物名称

farming-guide

• item（string）：要获取刷取策略的物品名称

build-planner

• weapon（string）：配装所用的武器类型
• playstyle（string）：期望的玩法风格（例如，“防御型”、“DPS”等）

错误处理

服务包含全面的错误处理和日志记录：

• API 连接错误
• 资源未找到错误
• 参数无效错误

所有错误都会连同详细信息妥善记录到控制台，以帮助调试。

开发

该服务使用 TypeScript 构建，并使用：

• Model Context Protocol（MCP）SDK
• Zod 进行参数验证
• Fetch API 发送 MHW DB API 请求
• 内存缓存存储 API 响应

要修改或扩展服务：

1. 修改 mhw-mcp-server.ts
2. 使用 npm run dev 时，服务会自动重新加载

贡献

欢迎贡献！请随时提交包含新功能、修复或改进的拉取请求。

许可证

MIT License - 可随意按自己的意愿使用此项目。