Minecraft Mod
A Fabric mod that implements a Model Context Protocol (MCP) server, enabling AI assistants like Claude to interact with Minecraft through structured commands.
What is Minecraft Mod?
Minecraft Mod is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to fabric mod that implements a model context protocol (mcp) server, enabling ai assistants like claude to interact with minecraft through structured commands.
A Fabric mod that implements a Model Context Protocol (MCP) server, enabling AI assistants like Claude to interact with Minecraft through structured commands.
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Fabric mod that implements a Model Context Protocol (MCP)
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx modConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Minecraft Mod
The Minecraft MCP Server Mod is a Fabric mod for Minecraft 1.21.11 that implements a Model Context Protocol server inside the game, allowing AI assistants like Claude to control Minecraft through structured JSON commands over HTTP. It exposes tools for executing commands, reading player state, scanning block areas, and taking screenshots, with configurable safety limits.
Prerequisites
- Minecraft 1.21.11 (Java Edition) with Java 21+
- Fabric Loader 0.18.4 or later installed
- Fabric API 0.141.3+1.21.11 mod installed
- Claude Desktop or another MCP-compatible client on the same machine
Install Fabric Loader
Download the Fabric Loader installer from fabricmc.net and run it, selecting Minecraft version 1.21.11. This creates a new Fabric profile in the Minecraft launcher.
Download and place the mod JAR
Download the mcp-server-mod JAR from the GitHub releases page and place it in your .minecraft/mods folder along with the Fabric API JAR for version 0.141.3+1.21.11.
Launch Minecraft with the Fabric profile
Start Minecraft using the Fabric profile. On first load, the mod creates config/mcp.json with default settings. The MCP HTTP server starts automatically on port 8080.
Configure the MCP server settings
Edit .minecraft/config/mcp.json to adjust safety settings, allowed commands, and the server port if 8080 is in use. The max_area_size defaults to 50 blocks per axis.
{
"server": {
"port": 8080,
"host": "localhost",
"max_area_size": 50,
"allowed_commands": ["fill", "clone", "setblock", "summon", "tp", "give", "gamemode", "effect", "weather", "time"]
},
"client": {
"auto_start": true,
"notifications": true
}
}Configure Claude Desktop to connect
Add the MCP server URL to your Claude Desktop configuration. The server runs at http://localhost:8080/mcp and is accessed by Claude as an HTTP MCP server.
Minecraft Mod Examples
Client configuration
Claude Desktop configuration connecting to the Minecraft MCP server running on localhost port 8080.
{
"mcpServers": {
"minecraft": {
"url": "http://localhost:8080/mcp"
}
}
}Prompts to try
Prompts to control Minecraft through Claude once the mod is running.
- "What is my current position, health, and what am I holding?"
- "Build a 10x5x8 oak plank structure at my current location"
- "Summon a villager next to me"
- "Scan the blocks in a 10-block radius around me and tell me what materials are nearby"
- "Take a screenshot of what I'm currently looking at"Troubleshooting Minecraft Mod
Claude cannot connect to the Minecraft MCP server
Confirm Minecraft is running with the Fabric profile and the mod is loaded (you should see a startup message in the chat or logs). Verify port 8080 is not blocked by a firewall: curl http://localhost:8080/mcp should return a response.
Commands are blocked with safety validation error
The mod validates commands against the allowed_commands list in config/mcp.json. Add any additional commands you need to the allowed_commands array and reload the config by restarting Minecraft.
take_screenshot tool returns an error on a dedicated server
Screenshot functionality requires client-side rendering and is disabled on dedicated Minecraft servers. This tool only works when running in single-player or as a client-side mod. The mod automatically detects the environment and disables client-only features on servers.
Frequently Asked Questions about Minecraft Mod
What is Minecraft Mod?
Minecraft Mod is a Model Context Protocol (MCP) server that fabric mod that implements a model context protocol (mcp) server, enabling ai assistants like claude to interact with minecraft through structured commands. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Minecraft Mod?
Follow the installation instructions on the Minecraft Mod GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Minecraft Mod?
Minecraft Mod works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Minecraft Mod free to use?
Yes, Minecraft Mod is open source and available under the CC0-1.0 license. You can use it freely in both personal and commercial projects.
Minecraft Mod Alternatives — Similar Browser Automation Servers
Looking for alternatives to Minecraft Mod? Here are other popular browser automation servers you can use with Claude, Cursor, and VS Code.
Chrome DevTools MCP
★ 40.6kAI-powered Chrome automation server with natural language element detection. Control Chrome browser through MCP protocol for testing, debugging, and performance analysis. Features 91% accuracy in element location, works with free AI models, and suppo
UI TARS Desktop
★ 34.9k📇 🏠 - Browser automation capabilities using Puppeteer, both support local and remote browser connection.
Playwright
★ 32.8kA production-ready browser automation server that enables AI assistants to interact with web pages using tools for navigation, element interaction, and data extraction. It features a built-in Inspector UI and robust crash recovery for reliable automa
Page Agent
★ 18.0kJavaScript in-page GUI agent. Control web interfaces with natural language.
Chrome
★ 11.7kAn extension-based MCP server that enables AI assistants to control your browser, leveraging existing sessions and login states for automation and content analysis. It provides over 20 tools for semantic tab search, interactive element manipulation,
LAMDA
★ 7.8kThe most powerful Android RPA agent framework, next generation mobile automation.
Browse More Browser Automation MCP Servers
Explore all browser automation servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Minecraft Mod 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 Mod?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.