Minecraft
A Minecraft MCP Server powered by Mineflayer API. It allows to control a Minecraft character in real-time, allowing AI assistants to build structures, explore the world, and interact with the game environment through natural language instruction
What is Minecraft?
Minecraft is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to minecraft mcp server powered by mineflayer api. it allows to control a minecraft character in real-time, allowing ai assistants to build structures, explore the world, and interact with the game envir...
A Minecraft MCP Server powered by Mineflayer API. It allows to control a Minecraft character in real-time, allowing AI assistants to build structures, explore the world, and interact with the game environment through natural language instruction
This server falls under the Browser Automation category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Minecraft MCP Server powered by Mineflayer API. It allows
Use Cases
Maintainer
Works with
Installation
NPM
npx -y mcp-minecraftManual Installation
npx -y mcp-minecraftConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Minecraft
mcp-minecraft is an MCP server powered by the Mineflayer API that lets AI assistants like Claude control a Minecraft character in real-time through natural language instructions. It exposes tools for movement, block interaction, inventory management, crafting, smelting, chat, and game state inspection, enabling the AI to build structures, explore the world, and complete in-game tasks autonomously. You can upload images of buildings and ask the bot to replicate them, or give freeform instructions like 'mine some wood and build a house'. It works with Minecraft Java Edition and requires a running Minecraft server.
Prerequisites
- Node.js 20.10.0 or later installed
- A running Minecraft Java Edition server or singleplayer world with LAN sharing enabled (Minecraft 1.21.x supported)
- An MCP-compatible client such as Claude Desktop
- Git installed (for npx GitHub installation)
Start a Minecraft Java Edition server or LAN world
Launch Minecraft Java Edition and either start a local server or open your singleplayer world to LAN (Escape > Open to LAN). Note the port number shown in chat. The bot supports Minecraft version 1.21.x.
Configure Claude Desktop
Add the mcp-minecraft server to your Claude Desktop config. Replace localhost and 25565 with your actual server host and port. The --username flag sets the bot's in-game name.
{
"mcpServers": {
"minecraft": {
"command": "npx",
"args": [
"-y",
"github:yuniko-software/minecraft-mcp-server",
"--host", "localhost",
"--port", "25565",
"--username", "ClaudeBot"
]
}
}
}Restart Claude Desktop
Fully quit and relaunch Claude Desktop. On first launch, npx will download the server package from GitHub. The bot will automatically join your Minecraft server.
Verify the bot has joined the game
Check your Minecraft server console or in-game player list. You should see 'ClaudeBot' (or whatever username you configured) join the world.
Start giving instructions in Claude Desktop
Open a conversation in Claude Desktop and start issuing Minecraft commands in natural language. The AI will use the mcp-minecraft tools to control the bot.
Minecraft Examples
Client configuration
Claude Desktop config for mcp-minecraft connecting to a local Minecraft Java Edition server on the default port.
{
"mcpServers": {
"minecraft": {
"command": "npx",
"args": [
"-y",
"github:yuniko-software/minecraft-mcp-server",
"--host", "localhost",
"--port", "25565",
"--username", "ClaudeBot"
]
}
}
}Prompts to try
Natural language commands to control your Minecraft bot through Claude Desktop.
- "Walk to coordinates 100, 64, 200 and tell me what blocks are nearby."
- "Mine 20 logs of oak wood and then craft a crafting table."
- "Build a 5x5 stone house with a door opening at the south side."
- "What items do I currently have in my inventory?"
- "Find the nearest cow and tell me its position."Troubleshooting Minecraft
Bot fails to connect to the Minecraft server
Verify that --host and --port match your actual Minecraft server address and port. For LAN worlds, the port is shown in the in-game chat when you open to LAN. Ensure your firewall allows connections on that port. The bot only supports Minecraft Java Edition 1.21.x — check your game version.
npx download fails or takes too long on first start
The first run downloads the server from GitHub. Ensure you have internet access and Git installed. If it fails, try running the npx command directly in your terminal to see the error: npx -y github:yuniko-software/minecraft-mcp-server --host localhost --port 25565 --username ClaudeBot
Bot connects but movement or block commands have no effect
Ensure the Minecraft world has the bot spawned in a valid location and is not in spectator mode. Check that the game is not paused. If in a singleplayer LAN world, make sure cheats are enabled if the bot needs to teleport or change game mode.
Frequently Asked Questions about Minecraft
What is Minecraft?
Minecraft is a Model Context Protocol (MCP) server that minecraft mcp server powered by mineflayer api. it allows to control a minecraft character in real-time, allowing ai assistants to build structures, explore the world, and interact with the game environment through natural language instruction It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Minecraft?
Install via npm with the command: npx -y mcp-minecraft. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).
Which AI clients work with Minecraft?
Minecraft works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Minecraft free to use?
Yes, Minecraft is open source and available under the Apache 2.0 license. You can use it freely in both personal and commercial projects.
Minecraft Alternatives — Similar Browser Automation Servers
Looking for alternatives to Minecraft? 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 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?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.