minecraft-mcp-server MCP — 사용 사례, 설치 & 라이브 데모

왜 쓰나요

핵심 기능

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

라이브 데모

실제 사용 모습

minecraft-mcp-server-2.replay ▶ 준비됨

0/0

설치

클라이언트 선택

~/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"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config 열기. 저장 후 앱 재시작.

~/.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는 Claude Desktop과 동일한 mcpServers 스키마 사용. 프로젝트 설정이 전역보다 우선.

VS Code → Cline → MCP Servers → Edit

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

Cline 사이드바의 MCP Servers 아이콘 클릭 후 "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"
      ]
    }
  }
}

Claude Desktop과 같은 형식. Windsurf 재시작 후 적용.

~/.continue/config.json

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

Continue는 맵이 아닌 서버 오브젝트 배열 사용.

~/.config/zed/settings.json

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

context_servers에 추가. 저장 시 Zed가 핫 리로드.

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

한 줄 명령. claude mcp list로 확인, claude mcp remove로 제거.

사용 사례

실전 활용법: minecraft-mcp-server

How to build a Minecraft structure with AI assistance

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

언제 쓸까: You want to build something complex in Minecraft without placing every block manually.

사전 조건

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

흐름

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.✓ 복사됨

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

Add a second floor with the same layout and a staircase connecting them.✓ 복사됨

→ Second floor built with stairs

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

함정

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

언제 쓸까: You need resources but don't want to grind for them.

사전 조건

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

흐름

Explore surroundings

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

→ 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.✓ 복사됨

→ Mining progress updates and smelting confirmation

결과: Resources gathered and processed automatically.

함정

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

조합

다른 MCP와 조합해 10배 효율

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.✓ 복사됨

도구

이 MCP가 노출하는 것

도구	입력	언제 호출
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

비용 및 제한

운영 비용

API 쿼터: N/A — connects directly to Minecraft LAN
호출당 토큰: 100–500 tokens per action
금액: Free MCP server — requires Minecraft Java Edition ($26.95)
팁: Give high-level instructions ('build a house') rather than individual block placements to reduce calls.

보안

권한, 시크릿, 파급범위

자격 증명 저장: N/A — connects to LAN game

데이터 외부 송신: Connects to your local Minecraft LAN server only

문제 해결

자주 발생하는 오류와 해결

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.

확인: 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.

확인: 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.

확인: Check bot position relative to target

대안

minecraft-mcp-server 다른 것과 비교

대안	언제 쓰나	단점/장점
Roblox Studio MCP	You want AI-assisted game development in Roblox instead of Minecraft	Different platform and audience

minecraft-mcp-server

왜 쓰나요

핵심 기능

라이브 데모

실제 사용 모습

설치

클라이언트 선택

사용 사례

실전 활용법: minecraft-mcp-server

How to build a Minecraft structure with AI assistance

사전 조건

흐름

함정

Send an AI bot to explore and gather resources in Minecraft

사전 조건

흐름

함정

조합

다른 MCP와 조합해 10배 효율

도구

이 MCP가 노출하는 것

비용 및 제한

운영 비용

보안

권한, 시크릿, 파급범위

문제 해결

자주 발생하는 오류와 해결

대안

minecraft-mcp-server 다른 것과 비교

더 보기

리소스