Minecraft Dev
Model Context Protocol server for Minecraft Development
What is Minecraft Dev?
Minecraft Dev is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server for minecraft development
Model Context Protocol server for Minecraft Development
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Model Context Protocol server for Minecraft Development
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx minecraft-devConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Minecraft Dev
The Minecraft Dev MCP server gives AI assistants direct access to decompiled Minecraft source code, mod analysis, and mapping namespaces (Yarn, Mojmap, Intermediary), making it a powerful assistant for Minecraft mod development. It can download and decompile any Minecraft version from 1.14 onward, search source code with full-text indexing, analyze Fabric/Forge/NeoForge mods, validate Mixin annotations, and diff classes between game versions. Developers use it to get accurate API references and code context without leaving their AI coding workflow.
Prerequisites
- Node.js 18 or later
- Java 17 or later (required for decompilation; verify with 'java -version')
- An MCP-enabled client such as Claude Desktop or Cursor
- Sufficient disk space for cached Minecraft source (several hundred MB per version)
Verify Java 17+ is installed
The server uses Java under the hood to decompile Minecraft class files. Java 17 or later is required.
java -versionInstall the package globally (optional)
Install the package globally with npm if you prefer a persistent install, or skip this step to use npx directly in your config.
npm install -g @mcdxai/minecraft-dev-mcpAdd the server to your MCP client configuration
Open your MCP client's config file and add the minecraft-dev entry. Using npx with -y means no separate install step is needed.
{
"mcpServers": {
"minecraft-dev": {
"command": "npx",
"args": ["-y", "@mcdxai/minecraft-dev-mcp"]
}
}
}Restart your MCP client
Restart Claude Desktop or your chosen MCP client for it to detect the new server. On first use, the server will download and cache Minecraft source for the version you request.
Optional: set environment variables
Two optional environment variables let you control cache location and logging verbosity. Add them to the env block in your config if needed.
{
"mcpServers": {
"minecraft-dev": {
"command": "npx",
"args": ["-y", "@mcdxai/minecraft-dev-mcp"],
"env": {
"CACHE_DIR": "/path/to/custom/cache",
"LOG_LEVEL": "INFO"
}
}
}
}Minecraft Dev Examples
Client configuration
Complete claude_desktop_config.json entry using npx. Java 17+ must be on your PATH for decompilation to work.
{
"mcpServers": {
"minecraft-dev": {
"command": "npx",
"args": ["-y", "@mcdxai/minecraft-dev-mcp"]
}
}
}Prompts to try
Example prompts that leverage the server's decompilation, mapping, and search capabilities.
- "Show me the Minecraft 1.21 source for net.minecraft.world.entity.Entity using Yarn mappings"
- "What changed in the Player class between Minecraft 1.20 and 1.21?"
- "Analyze the mixins in my Fabric mod and check for annotation errors"
- "Search the Minecraft 1.21 source for all usages of BlockState"
- "List the tools available in this MCP server"Troubleshooting Minecraft Dev
Decompilation fails with a Java error
Ensure Java 17 or later is installed and the 'java' binary is on your system PATH. Run 'java -version' to confirm. The decompiler cannot run without a compatible JVM.
First request is very slow
On the first use for a given Minecraft version, the server downloads and decompiles the game JAR, which can take several minutes. Subsequent requests use the cached results and are much faster. Set CACHE_DIR to a fast SSD location to improve performance.
npx command times out or fails to install
Try installing the package globally with 'npm install -g @mcdxai/minecraft-dev-mcp' and change the command in your config to 'minecraft-dev-mcp' with no args. This avoids npx resolution latency.
Frequently Asked Questions about Minecraft Dev
What is Minecraft Dev?
Minecraft Dev is a Model Context Protocol (MCP) server that model context protocol server for minecraft development It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Minecraft Dev?
Follow the installation instructions on the Minecraft Dev GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Minecraft Dev?
Minecraft Dev works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Minecraft Dev free to use?
Yes, Minecraft Dev is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
Minecraft Dev Alternatives — Similar Developer Tools Servers
Looking for alternatives to Minecraft Dev? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Minecraft Dev in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Minecraft Dev?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.