Minecraft Development MCP Server
github.com
- Free plan
- Windows
- macOS
- Linux
- API
- Self-hosted
What Minecraft Development MCP Server is
Minecraft Development MCP Server gives AI assistants tools to retrieve and analyze Minecraft source code and mods. On first use, it can download, remap, and decompile a game version, then store the results in a local cache. SQLite FTS5 indexes support full-text searches across Minecraft and mod source. Its 21 tools cover source, mapping and registry data, analysis and validation, and mod analysis. Developers can check Mixin code, Fabric access wideners, and Forge or NeoForge access transformers against source or bytecode. Class-level and AST-level comparisons can show version changes and potential breaking changes. Mod JAR analysis supports Fabric, Quilt, Forge, and NeoForge and covers metadata, dependencies, entry points, and mixin configurations. Mapping namespaces include Yarn, Mojmap, Intermediary, and obfuscated; Yarn support runs through Minecraft 1.21.11, while versions 26.1 and later support Mojmap but not Yarn. Setup is documented for Claude Desktop and Claude Code, as well as HTTP clients and editors. A standalone CLI can run the tools and return JSON. The MIT-licensed project is free and requires Node.js 18 or newer, plus Java 17 or newer for decompilation and remapping.
Who it suits
It suits Minecraft mod developers who want AI assistant tools for source searches, mod analysis, validation, or version comparisons. Users need Node.js 18 or newer, and Java 17 or newer for decompilation and remapping.
Good to know, and what to watch
- Supports Fabric, Quilt, Forge, and NeoForge
- Searches Minecraft and mod source text
- Validates mixins and loader-specific access rules
- Compares versions at class and AST levels
- Standalone CLI returns JSON
- Requires Node.js 18 or newer
- Java 17 or newer needed for decompilation and remapping
- Cache uses about 400–500 MB per Minecraft version
- Non-loopback HTTP binding disables DNS-rebinding protection
Plans
Every plan and priceOpen source
Free plan
Getting started
- Install Node.js 18 or newer and Java 17 or newer
- Install the package globally with npm, or use npx or a source build
- Configure it for Claude Desktop, Claude Code, an HTTP client, or the standalone CLI
- Run a tool that downloads and caches the needed Minecraft version
- Set CACHE_DIR if the local cache should use another location
- Keep HTTP binding on loopback when DNS-rebinding protection is required
Limits to check
The local cache consumes about 400–500 MB for each Minecraft version. Yarn mappings are supported through 1.21.11, while versions 26.1 and later support Mojmap and not Yarn.
The Club's review
Overview
Minecraft Development MCP Server is a free, MIT-licensed toolkit that gives AI assistants and other clients access to Minecraft source and mod-analysis tools. It best suits mod developers working across game versions or investigating third-party mods. Its breadth is useful, but local Java and Node.js requirements and a substantial per-version cache are part of the deal.
Key features
The project documents 21 tools for source code, mappings and registry data, analysis and validation, and mod analysis. It can download, remap, and decompile Minecraft versions on first use, then cache the results and build SQLite FTS5 indexes for full-text search across Minecraft and mod source. This gives developers a searchable local corpus; the trade-off is the initial download and roughly 400–500 MB of cache per Minecraft version.
Mapping support includes Yarn, Mojmap, Intermediary, and obfuscated namespaces. Yarn covers Minecraft 1.14 through 1.21.11, while versions 26.1 and later support Mojmap but not Yarn. That split matters for developers maintaining projects across older and newer version lines, who may need to adjust their mapping workflow.
For mod inspection, the server can analyze and decompile 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. Those checks put source inspection and compatibility review in the same workflow, particularly useful when a mod touches loader-specific mechanisms.
Class-level and AST-level comparisons between Minecraft versions can expose changes such as altered method signatures and fields, helping developers spot potential breakage before updating. The scope is focused on code and compatibility analysis rather than a complete mod-development environment.
The README documents setup for Claude Desktop and Claude Code, an HTTP transport for clients or editors, and a standalone CLI that invokes the tools and returns JSON. Global npm installation is recommended, with npx and building from source also documented. Node.js 18 or newer is required, and Java 17 or newer is needed for decompilation and remapping.
Downloaded JARs, mappings, decompiled source, and search databases remain in a local cache, which can be relocated with CACHE_DIR. For HTTP use, loopback binding at 127.0.0.1 enables DNS-rebinding protection; binding to a non-loopback host disables it and should be limited to a trusted network, ideally behind a reverse proxy or authentication.
Pricing
The Open source plan costs free and includes the MIT-licensed software. There are no paid plans described, so it suits individual developers and teams prepared to install and maintain the tool locally. The cost is not the limiting factor: users need Node.js 18 or newer, Java 17 or newer for decompilation and remapping, and enough disk space for each version’s cache.
Platforms
The server supports API use and self-hosting on Windows, macOS, and Linux, including WSL. Its documented integrations include Claude Desktop and Claude Code, as well as HTTP transport for clients or editors. This favors developers comfortable managing local tooling over users seeking a hosted service.
Who it's for
Choose it if you develop Minecraft mods and want AI-assisted access to game and mod source, mapping translation, loader-specific validation, or version comparisons. It is also useful for inspecting third-party mod JARs. Look elsewhere if you need a hosted service, cannot meet the runtime requirements, or have limited storage for local version caches.
Pros and cons
- Pros: Source search, mod analysis, validation, and version comparison sit in one toolset, reducing the need to switch among separate inspection workflows.
- Pros: Support for four mod loaders and several mapping namespaces covers varied mod projects, with clear version support for Yarn and Mojmap.
- Pros: Free, MIT-licensed software can be used through MCP clients or a standalone JSON-returning CLI.
- Cons: Node.js and Java prerequisites make setup less suitable for users who want a ready-to-use service.
- Cons: A cache of about 400–500 MB per Minecraft version can add up for developers working across many versions.
- Cons: Yarn is unavailable for versions 26.1 and later, which complicates workflows that depend on it across that boundary.
Alternatives
Minecraft Mod Development Tools is a broader directory of tools to consider when you want to compare options beyond this MCP-focused toolkit.
Choose IntelliJ IDEA instead if you want a Java and Kotlin IDE: its core functionality is free, while Ultimate is $100 a year. Gradle is the better fit when the need is an open-source build system rather than source and mod analysis. For Java decompilation specifically, Vineflower is a free alternative.
Visual Studio Code is another free development environment to consider. Blockbench is free and may suit projects centered on modeling and design. For Forge build workflows, consider ForgeGradle; for an experimental Gradle project requiring Gradle 8.1 or newer, consider Architectury Loom. To publish to CurseForge through Gradle, consider the free, MIT-licensed CurseForge Gradle Publish Plugin.
Verdict
Minecraft Development MCP Server is a strong choice for mod developers who want AI-assisted source search, loader-aware validation, and version analysis in one free local toolkit. Its main advantage is the breadth of code-focused tools; its main drawback is the combination of runtime prerequisites and per-version storage demands. Pick it when that analysis belongs in your workflow, and look elsewhere if you need a hosted, low-maintenance environment.
The verdict
The server brings source, mapping, validation, and mod analysis tools into AI-assisted Minecraft development workflows. Check the mapping coverage, runtime requirements, and local cache size against the versions and setup you use.
Questions people ask
Is the server free?
Yes. The Open source plan is listed as free, and the repository uses the MIT license.
Which Minecraft mappings are available?
It supports Yarn, Mojmap, Intermediary, and obfuscated namespaces. Yarn is available for 1.14–1.21.11; 26.1 and later use Mojmap instead.
Which mod loaders can it analyze?
Mod JAR analysis supports Fabric, Quilt, Forge, and NeoForge.
What integrations are documented?
The project documents setup with Claude Desktop and Claude Code, an HTTP transport for clients or editors, and a standalone CLI that returns JSON.
What does it require to run?
Node.js 18 or newer is required, and Java 17 or newer is required for decompilation and remapping.
Where does it run?
Supported platforms are Windows, macOS, Linux, and Windows Subsystem for Linux.
What the maker publishes
- Features
- It can download, remap, and decompile Minecraft versions on first use, then cache the results. source
- HTTP security
- The README says loopback binding enables DNS-rebinding protection automatically and warns that binding to a non-loopback host disables that protection. source
- Installation
- The README recommends global npm installation and also documents running it with npx or building from source. source
- Install options
- The README recommends global installation through npm and also documents running the package with npx or building from source. source
- Integrations
- The README documents setup for Claude Desktop and Claude Code, and also describes an HTTP transport for clients or editors. source
- Intended users
- The README describes the tools as supporting Minecraft mod development workflows, including analyzing third-party mods, validating mixins, and checking version changes. source
- License
- The repository identifies its license as MIT. source
- Local CLI
- A standalone CLI can invoke the server's tools without an MCP client and returns JSON output. source
- Mapping coverage
- Yarn and Mojmap are supported for versions 1.14 through 1.21.11; versions 26.1 and later support Mojmap, while Yarn is unavailable. source
- Mappings
- It supports Yarn, Mojmap, Intermediary, and obfuscated mapping namespaces for symbol translation. source
- Minecraft source
- It can retrieve and search decompiled Minecraft Java source, with on-demand downloads and cached results. source
- Mod loaders
- Its mod JAR analysis supports Fabric, Quilt, Forge, and NeoForge. source
- Mod support
- It can analyze and decompile Fabric, Quilt, Forge, and NeoForge mod JARs, including metadata, dependencies, entry points, and mixin configurations. source
- Purpose
- Minecraft Dev MCP gives AI assistants access to tools for decompiling, remapping, searching, and analyzing Minecraft source code. source
- Requirements
- The project requires Node.js 18 or newer and Java 17 or newer for decompilation and remapping. source
- Search
- It provides SQLite FTS5 indexes for full-text search across Minecraft and mod source. source
- Security
- The README says loopback binding at 127.0.0.1 enables DNS-rebinding protection; binding to a non-loopback host disables that protection and should be limited to a trusted network, ideally behind a reverse proxy or authentication. source
- Storage
- The README says its platform-specific cache uses about 400–500 MB per Minecraft version and can be relocated with CACHE_DIR. source
- Storage and disk use
- Downloaded JARs, mappings, decompiled source, and search databases are stored in a local cache that uses about 400–500 MB per Minecraft version. source
- Support
- The package metadata links bug reports to the project’s GitHub Issues page. source
- Toolset
- The project documents 21 tools in four categories for source code, mappings and registry data, analysis and validation, and mod analysis. source
- Validation
- It can validate Mixin code, Fabric access wideners, and Forge or NeoForge access transformers against Minecraft source or bytecode. source
- Version comparison
- It offers class-level and AST-level comparisons between Minecraft versions to show changes and potential breaking changes. source
- Version comparisons
- It compares Minecraft versions at class and AST levels to identify changes such as modified method signatures and fields. source
Checked against the maker's pages on 8 Oct 2026.