Best for
- Users who want to experience AI-driven automated players in Minecraft
- Users using Claude Desktop or compatible MCP clients
M
Minecraft MCP Server
Community
MCP server to control a Minecraft character through natural language
GitHub source repository ↗
37FMRS · D
This project provides a feature-rich MCP server for Minecraft, integrated with Mineflayer, enabling AI to control characters in real-time. Installation is straightforward, but there are version limitations and potential control risks.
This is a Minecraft MCP server powered by the Mineflayer API. It allows AI assistants like Claude to control a Minecraft character in real-time, enabling them to build structures, explore the world, and interact with the game environment through natural language instructions. Currently supports Minecraft version 1.21.11.
Tools
get-position
Get the current position of the bot
move-to-position
Move to specific coordinates
look-at
Make the bot look at specific coordinates
jump
Make the bot jump
move-in-direction
Move in a specific direction for a duration
fly-to
Make the bot fly directly to specific coordinates
list-inventory
List all items in the bot's inventory
find-item
Find a specific item in inventory
equip-item
Equip a specific item
place-block
Place a block at specified coordinates
dig-block
Dig a block at specified coordinates
get-block-info
Get information about a block
find-blocks
Find one or more nearby blocks of a specific type
smelt-item
Smelt items using a furnace-like block
find-entity
Find the nearest entity of a specific type
send-chat
Send a chat message in-game
read-chat
Get recent chat messages from players
detect-gamemode
Detect the gamemode on game
Setup
Ensure Node.js >= 20.10.0 and Git are installed. Run Minecraft, create a singleplayer world and open it to LAN (ESC -> Open to LAN). Install Claude Desktop, open File -> Settings -> Developer -> Edit Config. Add the MCP server configuration to claude_desktop_config.json (see install_config). Restart Claude Desktop; the bot will join the game automatically.
claude_desktop_config.json
{
"mcpServers": {
"minecraft": {
"command": "npx",
"args": [
"-y",
"github:yuniko-software/minecraft-mcp-server",
"--host",
"localhost",
"--port",
"25565",
"--username",
"ClaudeBot"
]
}
}
}
Fit and risk
Not for
- Users needing support for the latest Minecraft versions (currently only 1.21.11)
- Users seeking commercial support or official maintenance
Required permissions
- MCP server requires network access to connect to the Minecraft server
- Requires running npx command to start the server
- Requires Minecraft server to be opened to LAN and port (default 25565) accessible
Risks and side effects
- Controlling the Minecraft character can lead to unintended in-game actions, such as breaking blocks or moving incorrectly
- Ambiguous instructions may cause the AI to perform dangerous actions; user supervision is required
- Connection to the Minecraft server may be unstable, causing the bot to disconnect
- Server currently only supports specific versions; upgrading Minecraft may cause incompatibility
Troubleshooting
- Ensure the Minecraft world is opened to LAN and the host/port are correct
- Check Node.js version is >= 20.10.0
- Fully quit and restart Claude Desktop to ensure the MCP server loads correctly
- Check Claude Desktop logs for error messages
Use cases
Let AI assistants build structures in Minecraft based on instructions
Let AI assistants explore the world and gather resources
Interact with in-game players via natural language
Supported clients
Claude DesktopFull support