An MCP (Model Context Protocol) server that provides tools and resources for accessing Monster Hunter World game data via the MHW DB API.

• monster://{id} - Get detailed information about a specific monster
• armor-set://{id} - Get detailed information about a specific armor set

• find-monster - Search for monsters by name and get their details including weaknesses, locations, and species
• find-weapon-path - Get the complete crafting tree path for a weapon, including all required materials
• find-armor-by-skill - Search for armor pieces that have specific skills

• monster-guide - Get comprehensive hunting guides for specific monsters
• farming-guide - Get efficient farming strategies for specific items
• build-planner - Get build recommendations based on weapon type and playstyle

1. Clone the repository
2. Install dependencies:

npm install

3. Start the server:

npm run dev

The server will start in stdio mode and connect to Roo automatically if the .roo/mcp.json configuration is present.

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

Response will include:

• Monster name and type
• Species information
• Locations where it can be found
• Element/status weaknesses
• Description

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

Response will include:

• Complete upgrade path
• Required materials for each step
• Material sources/descriptions

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

Response will include:

• List of matching armor pieces
• Armor stats and rarity
• Skill levels
• Crafting requirements

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

Response will provide:

1. Weaknesses and resistances
2. Recommended weapons/elements
3. Important items to bring
4. Key mechanics to watch for
5. Recommended armor skills

Returns detailed monster information from the MHW DB API.

Returns detailed armor set information from the MHW DB API.

• name (string): Full or partial monster name to search for

• name (string): Full or partial weapon name to search for

• skill (string): Full or partial skill name to search for

• monster (string): Name of the monster to get a guide for

• item (string): Name of the item to get farming strategies for

• weapon (string): Type of weapon for the build
• playstyle (string): Desired playstyle (e.g., "defensive", "DPS", etc.)

The server includes comprehensive error handling and logging:

• API connection errors
• Resource not found errors
• Invalid parameter errors

All errors are properly logged to the console with detailed information to help with debugging.

The server is built with TypeScript and uses:

• Model Context Protocol (MCP) SDK
• Zod for parameter validation
• Fetch API for MHW DB API requests
• In-memory caching for API responses

To modify or extend the server:

1. Make changes to mhw-mcp-server.ts
2. The server will automatically reload when using npm run dev

Contributions are welcome! Please feel free to submit pull requests with new features, fixes, or improvements.

MIT License - feel free to use this project as you wish.