Hytale MCP Server 🎮

The ultimate AI companion for Hytale Modding.

This is a Model Context Protocol (MCP) server that gives your AI Assistant (Claude Desktop, Cursor, Windsurf, etc.) deep knowledge about Hytale.

Features ✨

• 📚 Lore Database: Ask about Mobs (Kweebec, Trork), Items (Void Scythe), and Recipes.
• 🛠️ Modding API Docs: Full simulated documentation for the Hytale API (Plugins, ECS, WorldGen).
• 🏗️ Project Scaffolding: Instantly generate build.gradle and hytale.json for new mods.
• 🐛 Error Analysis: Paste a crash log, and the AI will tell you how to fix it.
• 🎨 Asset Templates: Generate JSON for Models and Textures.

Installation 📦

Method 1: Using npx (Recommended)

You can run this directly without installing it globally.

Claude Desktop Configuration: Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "hytale": {
      "command": "npx",
      "args": ["-y", "hytale-mcp"]
    }
  }
}

Method 2: Install Globally

npm install -g hytale-mcp

Then configure your editor to run: hytale-mcp

Capabilities 🤖

Tools

• search_wiki: Search the entire knowledge base.
• get_api_reference: Get code examples for specific topics (e.g., spawning_entities, custom_ui).
• scaffold_project: Generate a new mod project structure.
• analyze_error: Diagnose Hytale-specific exceptions.
• generate_asset: Create JSON templates for models/textures.

Resources

• hytale://lore/mobs/list
• hytale://api/docs/list
• hytale://advanced/docs/list (WorldGen & ECS)

Development

1. Clone repo
2. npm install
3. npm run build
4. node build/index.js