MCP 마인크래프트 리모트

이 프로젝트는 arjunkmrm의 mcp-minecraft 에서 영감을 받았습니다. 원래는 로컬 Minecraft 서버 연결만 지원했지만, 이 프로젝트는 원격 Minecraft 서버 연결 지원을 추가하기 위해 처음부터 새로 만들어졌습니다.

MCP(Model Context Protocol)를 사용한 Minecraft 원격 제어.

특징

• AI 어시스턴트를 통해 Minecraft 플레이어에 연결하고 제어하세요
• Minecraft 세계를 탐색하고, 채굴하고, 건설하고, 상호 작용하세요
• 서버의 다른 플레이어와 채팅하세요
• 인벤토리, 플레이어 위치, 서버 정보를 확인하세요
• 점프, 몰래 움직이기, 달리기 등 고급 동작 제어
• 공격 및 추종을 포함한 엔티티 상호 작용
• 컨테이너 사용(상자, 용광로 등)
• 아이템 제작 및 주민 거래
• 상세한 재고 관리

설치

빠른 설치(권장)

지엑스피1

CLI 프롬프트에 따라 설정을 완료하세요.

수동 설치

용법

Claude Desktop과 함께 사용

1. Claude Desktop 구성 파일로 이동합니다.
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • 리눅스: ~/.config/Claude/claude_desktop_config.json
2. Minecraft Remote MCP 구성을 구성 파일에 추가합니다.

글로벌하게 설치한 경우:

로컬로 저장소를 복제한 경우:

3. 파일을 저장하고 Claude Desktop을 다시 시작하세요.
4. Claude와 새로운 대화를 시작하고 Minecraft 제어 명령을 사용해보세요.

중요한 서버 요구 사항

• 서버 온라인 모드 : Minecraft 서버는 server.properties 파일에 online-mode=false 설정해야 합니다. 이렇게 하면 봇이 Minecraft 세션 서버에 대한 인증 없이 연결할 수 있습니다.
• 인증이 있는 서버를 사용하는 경우, 연결할 때 유효한 프리미엄 계정 자격 증명을 제공해야 합니다.

사용 가능한 도구

핵심 기능

• connectToServer : 지정된 자격 증명으로 Minecraft 서버에 연결합니다.
• disconnectFromServer : Minecraft 서버와의 연결을 끊습니다.
• sendChat : 서버에 채팅 메시지를 보냅니다.
• getServerInfo : 연결된 서버에 대한 정보를 가져옵니다.

움직임

• getPosition : 현재 플레이어 위치 가져오기
• moveTo : 특정 좌표로 이동
• moveControl : 기본 이동 제어(앞으로, 뒤로, 왼쪽, 오른쪽, 점프, 질주, 몰래 움직이기, 정지)
• lookAt : 플레이어가 특정 방향이나 좌표를 바라보도록 합니다.

세계 상호 작용

• digBlock : 특정 좌표에서 블록 채굴
• placeBlock : 특정 좌표에 블록을 배치합니다.

재고 관리

• checkInventory : 기본 재고 확인
• inventoryDetails : 재고 항목에 대한 자세한 정보를 가져옵니다.
• equipItem : 인벤토리에서 아이템을 손이나 방어구 슬롯에 장착합니다.
• tossItem : 인벤토리에서 아이템을 던집니다.

엔티티 상호 작용

• getNearbyPlayers : 근처 플레이어 목록을 가져옵니다.
• getNearbyEntities : 근처의 모든 엔터티 목록을 가져옵니다.
• attackEntity : 특정 엔티티를 공격합니다
• useOnEntity : 특정 엔터티에서 보류된 항목 사용
• followEntity : 특정 엔터티를 팔로우합니다.

컨테이너 상호 작용

• openContainer : 특정 좌표에서 컨테이너(상자, 용광로 등)를 엽니다.
• withdrawItem : 열린 컨테이너에서 아이템을 꺼냅니다
• depositItem : 아이템을 열린 용기에 넣습니다.
• closeContainer : 현재 열려 있는 컨테이너를 닫습니다.

크래프팅

• getRecipes : 사용 가능한 제작 레시피 목록을 가져옵니다.
• craftItem : 사용 가능한 재료를 사용하여 아이템을 제작합니다.

거래

• listTrades : 근처 주민의 거래 가능 목록
• tradeWithVillager : 근처 주민과 거래

예시 프롬프트

기본 컨트롤

• "play.example.com에서 사용자 이름 player1을 사용하여 Minecraft 서버에 연결하세요."
• "현재 게임에서 내 위치는 무엇인가?"
• "좌표 x=100, y=64, z=-200으로 이동해 주세요"
• "3초 동안 앞으로 걷게 해주세요"
• "나를 저 산을 향해 뛰어오르게 하고 달려가게 해줘"

재고 및 품목

• "내 인벤토리에 무엇이 있는지 자세히 확인하세요"
• "내 손에 다이아몬드 검을 장착해줘"
• "내 인벤토리에서 흙 블록 5개를 던지세요"

블록 상호 작용

• "좌표 x=10, y=65, z=20에 블록을 파세요"
• "좌표 x=11, y=65, z=20에 돌 블록을 놓으세요"

엔티티 상호 작용

• "근처에 다른 플레이어가 있나요?"
• "내 주변 20블록 이내에 어떤 존재가 있나요?"
• ID 12345의 좀비를 공격하세요
• "스티브라는 플레이어를 따라가세요"

컨테이너 사용

• "좌표 x=100, y=64, z=200에 있는 상자를 여세요"
• "상자에서 철괴 10개를 꺼내세요"
• "상자에 조약돌 5개를 넣으세요"
• "컨테이너를 닫으세요"

제작 및 거래

• "나무 곡괭이를 만드는 데 사용할 수 있는 조리법이 뭐가 있나요?"
• "내 인벤토리에 있는 나무를 사용하여 막대기 4개를 만드세요"
• "근처 마을 사람들이 어떤 거래를 제공하는지 확인하세요"
• "마을 사람과 거래해서 에메랄드 10개를 얻으세요"

의사소통

• "채팅에 안녕하세요 메시지를 보내세요"
• "내가 다이아몬드를 찾았다고 모두에게 전해줘"

요구 사항

• 노드.js 18+
• MCP를 지원하는 AI 어시스턴트(Claude와 유사)
• Minecraft Java Edition 서버(버전 1.8 이상)

참고 : 이 도구는 바닐라 마인크래프트 1.21 버전에서만 작동하도록 테스트 및 검증되었습니다. 다른 버전이나 모드 서버에서도 작동할 수 있지만, 호환성은 보장되지 않습니다.

특허

MIT