minecraft-mcp-server MCP — Casos de uso, Instalar & Demo ao vivo

Por que usar

Principais recursos

Real-time Minecraft character control via natural language
Build structures from descriptions or images
Movement, flight, inventory management, and block interaction
Entity detection and interaction
In-game chat reading and sending

Demo ao vivo

Como fica na prática

minecraft-mcp-server-2.replay ▶ pronto

0/0

Instalar

Escolha seu cliente

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "minecraft-mcp-server-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/yuniko-software/minecraft-mcp-server"
      ]
    }
  }
}

Abra Claude Desktop → Settings → Developer → Edit Config. Reinicie após salvar.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "minecraft-mcp-server-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/yuniko-software/minecraft-mcp-server"
      ]
    }
  }
}

Cursor usa o mesmo esquema mcpServers que o Claude Desktop. Config de projeto vence a global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "minecraft-mcp-server-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/yuniko-software/minecraft-mcp-server"
      ]
    }
  }
}

Clique no ícone MCP Servers na barra lateral do Cline, depois "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "minecraft-mcp-server-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/yuniko-software/minecraft-mcp-server"
      ]
    }
  }
}

Mesmo formato do Claude Desktop. Reinicie o Windsurf para aplicar.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "minecraft-mcp-server-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/yuniko-software/minecraft-mcp-server"
      ]
    }
  ]
}

O Continue usa um array de objetos de servidor em vez de um map.

~/.config/zed/settings.json

{
  "context_servers": {
    "minecraft-mcp-server-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/yuniko-software/minecraft-mcp-server"
        ]
      }
    }
  }
}

Adicione em context_servers. Zed recarrega automaticamente ao salvar.

claude mcp add minecraft-mcp-server-2 -- TODO 'See README: https://github.com/yuniko-software/minecraft-mcp-server'

Uma linha só. Verifique com claude mcp list. Remova com claude mcp remove.

Casos de uso

Usos do mundo real: minecraft-mcp-server

How to build a Minecraft structure with AI assistance

👤 Minecraft players who want AI help with building ⏱ ~15 min beginner

Quando usar: You want to build something complex in Minecraft without placing every block manually.

Pré-requisitos

Minecraft Java Edition 1.21.11 — Create a singleplayer world and Open to LAN
minecraft-mcp-server configured — Add to Claude Desktop config with host, port, and username

Fluxo

Describe the build

Build a 10x10 stone house with oak wood corners, glass windows on each wall, an oak door, and a flat stone roof. Start at my current position.✓ Copiado

→ Bot begins placing blocks systematically, reporting progress
Modify the build

Add a second floor with the same layout and a staircase connecting them.✓ Copiado

→ Second floor built with stairs

Resultado: A complete structure built in Minecraft via natural language instructions.

Armadilhas

Bot doesn't have required blocks in inventory — Ensure the bot has materials or switch to Creative mode for unlimited blocks

Send an AI bot to explore and gather resources in Minecraft

👤 Minecraft players who want automated resource gathering ⏱ ~20 min beginner

Quando usar: You need resources but don't want to grind for them.

Pré-requisitos

Minecraft world open to LAN with bot connected — Configure and launch

Fluxo

Explore surroundings

Look around and tell me what biome we're in. Find the nearest cave entrance.✓ Copiado

→ Biome info and cave location
Gather resources

Go to the cave and mine all iron ore you can find. Come back and smelt it into iron ingots.✓ Copiado

→ Mining progress updates and smelting confirmation

Resultado: Resources gathered and processed automatically.

Armadilhas

Bot gets stuck on complex terrain — Use fly-to for navigation over rough terrain

Combinações

Combine com outros MCPs para 10× de alavancagem

minecraft-mcp-server-2 + filesystem

Save build plans as files and load them for construction

Save this house blueprint to a file so we can build it again in another world.✓ Copiado

Ferramentas

O que este MCP expõe

Ferramenta	Entradas	Quando chamar
get-position	none	Get the bot's current position
move-to-position	x: int, y: int, z: int	Navigate to a specific position
place-block	x: int, y: int, z: int, block_name: str	Place a block at a position
dig-block	x: int, y: int, z: int	Mine/dig a block
list-inventory	none	List items in the bot's inventory
find-blocks	block_name: str, range?: int	Find nearby blocks of a type
send-chat	message: str	Send a message in game chat

Custo e limites

O que custa rodar

Cota de API: N/A — connects directly to Minecraft LAN
Tokens por chamada: 100–500 tokens per action
Monetário: Free MCP server — requires Minecraft Java Edition ($26.95)
Dica: Give high-level instructions ('build a house') rather than individual block placements to reduce calls.

Segurança

Permissões, segredos, alcance

Armazenamento de credenciais: N/A — connects to LAN game

Saída de dados: Connects to your local Minecraft LAN server only

Solução de problemas

Erros comuns e correções

Bot can't connect to server

Ensure you opened the world to LAN (ESC → Open to LAN) and the port in your config matches the LAN port shown in chat.

Verificar: Check the Minecraft chat for 'Local game hosted on port XXXXX'

Bot disconnected

The Minecraft server may have kicked the bot for inactivity or invalid actions. Restart Claude Desktop to reconnect.

Verificar: Check Minecraft chat for kick messages

Can't place blocks — invalid position

The bot may be too far from the target position. Move closer first with move-to-position.

Verificar: Check bot position relative to target

Alternativas

minecraft-mcp-server vs. outros

Alternativa	Quando usar	Troca
Roblox Studio MCP	You want AI-assisted game development in Roblox instead of Minecraft	Different platform and audience

Mais

Recursos

📖 Leia o README oficial no GitHub

🐙 Ver issues abertas

🔍 Ver todos os 400+ servidores MCP e Skills