怪物猎人世界数据服务

一个提供怪物猎人世界游戏数据访问和工具支持的MCP服务器,包括怪物信息查询、装备搜索和狩猎指南等功能。

  • by likweitan
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 likweitan/mcp-mhworld

使用说明

怪物猎人世界助手MCP服务器

MCP(模型上下文协议)服务器,提供通过以下方式访问《怪物猎人世界》游戏数据的工具和资源 MHW DB API公司.

特性

资源

  • monster://{id} -获取特定怪物的详细信息
  • armor-set://{id} -获取特定护甲组的详细信息

工具

  • find-monster -按名称搜索怪物,并获取其详细信息,包括弱点、位置和物种
  • find-weapon-path -获取武器的完整制作树路径,包括所有必需的材料
  • find-armor-by-skill -搜索具有特定技能的护甲

鼓励

  • monster-guide -获取特定怪物的全面狩猎指南
  • farming-guide -为特定物品制定高效的耕作策略
  • build-planner -根据武器类型和游戏风格获取构建建议

安装

  1. 克隆存储库
  2. 安装依赖项:
npm install
  1. 启动服务器:
npm run dev

如果发生以下情况,服务器将以stdio模式启动并自动连接到Roo .roo/mcp.json 配置存在。

使用示例

查找怪物信息

// 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返回详细的装甲装备信息。

刀具参数

找到怪物

  • name (string):要搜索的完整或部分怪物名称

找到武器路径

  • name (string):要搜索的全部或部分武器名称

通过技能找到盔甲

  • skill (string):要搜索的全部或部分技能名称

提示参数

怪物向导

  • monster (string):要获取向导的怪物的名称

农业指南

  • item (string):要获取农业策略的项目名称

构建计划器

  • weapon (string):构建的武器类型
  • playstyle (字符串):所需的比赛风格(例如,“防守”、“DPS”等)

错误处理

服务器包括全面的错误处理和日志记录:

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

所有错误都会正确记录到控制台中,并提供详细信息以帮助调试。

发展

服务器使用TypeScript构建,并使用:

  • 模型上下文协议(MCP)SDK
  • Zod用于参数验证
  • 获取MHW DB API请求的API
  • API响应的内存内缓存

要修改或扩展服务器,请执行以下操作:

  1. 对以下内容进行更改 mhw-mcp-server.ts
  2. 使用时,服务器将自动重新加载 npm run dev

贡献

欢迎投稿!请随时提交带有新功能、修复或改进的拉取请求。

许可证

MIT许可证-您可以随意使用此项目。