minecraft-dev-mcp

Overview

Minecraft Dev MCP is a comprehensive Model Context Protocol server designed specifically for Minecraft mod developers. It provides native access to Minecraft development tools through MCP, allowing AI assistants to directly work with decompiled Minecraft source code, analyze mods, validate Mixin configurations, and compare between Minecraft versions. The server supports both WSL and Windows paths, making it versatile for different development environments.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• list_minecraft_versions

  List all available Minecraft versions and local cache status

  Try:Show me all available Minecraft versionsTry:What Minecraft versions are installed?
• decompile_minecraft_version

  Download, remap, and decompile a Minecraft version

  Try:Dec Minecraft 1.20.1 with Yarn mappingsTry:Force re-decompile version 1.19.2
• get_minecraft_source

  Get decompiled Java source for a specific Minecraft class

  Try:Show me the source code for net.minecraft.class.EntityTry:Get Player class from MC 1.20.1, lines 100-200
• search_minecraft_code

  Search Minecraft source code by class, method, field, or content

  Try:Find all methods that handle entity damageTry:Search for code related to block break events
• find_mapping

  Translate symbols between mapping namespaces

  Try:What's the Yarn name for method_1234?Try:Convert this obfuscated class name to Mojmap
• compare_versions

  Compare two Minecraft versions to identify changes

  Try:What changed between MC 1.19 and 1.20?Try:Show differences in registry entries from 1.18 to 1.18.2
• analyze_mixin

  Validate Mixin annotations against Minecraft source

  Try:Check this Mixin code for errorsTry:Validate my entity modification mixin
• analyze_mod_jar

  Analyze a mod JAR without decompiling

  Try:Tell me about this mod's dependenciesTry:What entry points does this Fabric mod have?
• decompile_mod_jar

  Decompile a mod JAR to readable Java source

  Try:Decompile this mod to Yarn mappingsTry:Get source code for mod fabric-example-mod
• search_mod_code

  Search decompiled mod source code

  Try:Find all custom item classes in this modTry:Search for event handlers in mod xyz
• get_registry_data

  Extract registry data from Minecraft

  Try:List all blocks in MC 1.20.1Try:Get all entity types from version 1.19
• search_documentation

  Search across Minecraft and Fabric documentation

  Try:Find documentation for fabric apiTry:Search for information about world generation

Comparable tools

Installation

npm install -g @mcdxai/minecraft-dev-mcp

{
  "mcpServers": {
    "minecraft-dev": {
      "command": "minecraft-dev-mcp"
    }
  }
}

{
  "mcpServers": {
    "minecraft-dev": {
      "command": "minecraft-dev-mcp"
    }
  }
}

FAQ

What Minecraft versions are supported?

The server supports Minecraft versions 1.14 and higher with automatic downloading and caching of client JARs.

Can I use this with both Windows and WSL?

Yes, the server fully supports both Windows paths (C:\\...) and WSL paths (/mnt/c/...) throughout all tools.

Compare minecraft-dev-mcp with