minecraft-dev

Minecraft Dev MCP Server is a powerful MCP (Model Context Protocol) server that enables AI agents and agentic CLIs to interact with Minecraft mod development workflows. It provides automated decompilation, mapping translation across Yarn, MojMap, Intermediary, and obfuscated mappings, source code access with full-text search, registry data extraction, mod analysis, mixin validation, version comparison, and integrated documentation lookups. With WSL compatibility and a focus on production-grade tooling, you can run the server locally or in environments that support Node.js 18+ and Java 17+ for decompilation tooling. The server is designed to be invoked from Claude Desktop or Claude Code, exposing a range of capabilities for decompiling Minecraft versions, inspecting registry data, performing code searches, and analyzing mod JARs.

To use the MCP server, install it via npm, NPX, or run it directly from source. Once the server is running, you can issue queries and requests such as decompiling a specific Minecraft version with a chosen mapping, retrieving decompiled source for a class, looking up registry entries, or running mod analysis on a JAR. The toolset includes mapping lookups, version diffs, and documentation search to help you navigate Minecraft internals and Fabric/Forge ecosystems. The system is designed to work across environments, including Windows, macOS, Linux, and WSL, making it suitable for agentic tools like Claude Code and Claude Desktop.

Prerequisites:\n- Node.js 18+ (and npm) installed on your system.\n- Java 17+ installed if you plan to use decompilation tooling locally.\n\n1) NPM (Recommended) - Global install:\nbash\nnpm install -g @mcdxai/minecraft-dev-mcp\n`````\n2) NPX (No Installation):\nbash\n# Run directly without installing the package globally\nnpx -y @mcdxai/minecraft-dev-mcp\n\n3) From Source:\n```bash\ngit clone https://github.com/MCDxAI/minecraft-dev-mcp.git\ncd minecraft-dev-mcp\nnpm install\nnpm run build\n\nAfter installation, you can start using the MCP server via the configuration example in the README (see mcp_config).\n\nNote: If you use Claude Desktop or Claude Code, you can configure the MCP server in Claude with the following example (NPX or npm-based options will be resolved by the host tool).

Tips and common considerations:\n- Ensure Node.js 18+ and Java 17+ are installed for full decompilation capabilities.\n- If you encounter network or caching issues, try clearing the central cache or re-running the installation using NPX to fetch the latest build.\n- The MCP server supports multiple mapping types (Yarn, MojMap, Intermediary, and obfuscated) for flexible decompilation workflows.\n- For Claude Desktop integration, restart Claude Desktop after updating the MCP server configuration to ensure the new server is loaded.\n- When using NPX, the server will be downloaded on demand; ensure you have network access to npm registry.\n- The npm package name for this server is @mcdxai/minecraft-dev-mcp; use the provided mcp_config if you’re integrating into an MCP client config.