Minecraft Development MCP Server

Overview

Minecraft Development MCP Server connects AI assistants and other clients to tools for retrieving, searching, and analyzing Minecraft and mod source. It is best for mod developers who want source inspection, compatibility checks, and version comparisons in an AI-assisted workflow. Its breadth is compelling for that work, provided Node.js, Java, and local disk space are available.

This MIT-licensed project is a development aid, not a mod loader or build system. MCP integrations and a standalone command-line interface give developers more than one way to reach its tools, but it is not a hosted, ready-to-use service.

Key features

The project documents 21 tools grouped around source code, mappings and registry data, analysis and validation, and mod analysis. It downloads, remaps, and decompiles Minecraft versions on first use, then caches the results and creates SQLite FTS5 indexes for searching Minecraft and mod source. That lets developers look across a local code corpus; the trade-off is a cache of about 400–500 MB per Minecraft version.

Symbol translation covers Yarn, Mojmap, Intermediary, and obfuscated namespaces, but mapping availability varies by game version. Yarn supports Minecraft 1.14 through 1.21.11; versions 26.1 and later support Mojmap, while Yarn is unavailable. Developers maintaining projects across these version ranges should account for that shift.

For mod work, the server analyzes and decompiles Fabric, Quilt, Forge, and NeoForge JARs, including metadata, dependencies, entry points, and mixin configurations. It can validate Mixin code, Fabric access wideners, and Forge or NeoForge access transformers against Minecraft source or bytecode. Class-level and AST-level version comparisons can surface changes such as altered method signatures and fields, making the toolkit useful for compatibility investigations without replacing the developer’s judgment about their code.

Setup documentation covers Claude Desktop and Claude Code, as well as HTTP transport for clients or editors. Installation options include global npm installation, npx, and building from source; a standalone CLI can invoke the tools without an MCP client and returns JSON. Node.js 18 or newer is required, and Java 17 or newer is needed for decompilation and remapping. HTTP users should keep the server on loopback when possible: binding to a non-loopback host disables DNS-rebinding protection and should be limited to a trusted network, ideally behind a reverse proxy or authentication.

Pricing

The Open source plan costs nothing. It includes the MIT-licensed software, with no paid tier or usage quota described. The price is zero, but operating costs include installing the required runtimes and accommodating the local cache; each additional Minecraft version adds about 400–500 MB.

Platforms

The server supports Windows, macOS, and Linux/WSL, and is also categorized for API and self-hosted use. Its runtime prerequisites make it a developer-oriented setup rather than a turnkey desktop app.

Who it's for

Choose it if you develop Minecraft mods and need one toolkit for searching game or mod source, inspecting third-party JARs, validating loader-specific compatibility code, or comparing game versions. It is especially relevant to developers already using Claude Desktop, Claude Code, another MCP client, or a compatible editor. Look elsewhere if you need a hosted service, do not want to install Node.js and Java, or cannot spare local cache space.

Pros and cons

• Pros: Source retrieval, full-text search, mod JAR analysis, validation, and version comparison sit in one documented toolset, reducing the need to switch among separate inspection utilities.
• Pros: Fabric, Quilt, Forge, and NeoForge are covered for mod analysis, and the CLI works without an MCP client.
• Pros: MIT licensing and a free plan make the software accessible without a subscription charge.
• Cons: Node.js 18+ and Java 17+ are prerequisites, and the cache can take 400–500 MB for each Minecraft version.
• Cons: Yarn coverage ends at 1.21.11; Minecraft 26.1 and later use Mojmap support instead.
• Cons: Exposing HTTP beyond loopback disables DNS-rebinding protection, so remote access calls for network restrictions and added safeguards.

Alternatives

Blockbench is a free option to consider when a cross-platform tool for Minecraft-related project work is a better fit than source-analysis and MCP tooling. Visual Studio Code is another free alternative if you want a general editor rather than this focused source-inspection server.

Architectury Loom may suit a Gradle-centered modding setup: it is experimental, requires Gradle 8.1 or newer, and supports IntelliJ IDEA and Visual Studio Code. Quilt Loom is a free, MIT-licensed alternative to consider for Quilt-oriented development.

Eclipse IDE is a free and open-source IDE option if you need an integrated development environment rather than MCP tools for Minecraft source. Fabric is the choice to consider when the need is the Fabric Loader itself; its download is the bare minimum, and most mods also require Fabric API. ForgeGradle and Gradle are other free alternatives for readers considering different development tooling, while Minecraft Mod Development Tools collects more options.

Verdict

Minecraft Development MCP Server is a strong fit for mod developers who want AI clients or a CLI to search and analyze Minecraft and mod code, validate compatibility-sensitive changes, and compare versions. Its decisive advantage is that breadth in a free, MIT-licensed toolkit; its main costs are runtime setup, per-version disk use, and uneven mapping coverage. Choose it when those trade-offs fit your workflow, and look elsewhere for a hosted service or a conventional editor or build tool.