마인크래프트 MCP 서버

⚠️ 중요 호환성 경고 : 2025년 3월 25일 기준으로 Minecraft 1.21.5가 출시되었습니다. 이 봇은 현재 Minecraft 1.21.5와 호환되지 않습니다 . 1.21.5 지원 업데이트가 출시될 때까지 Minecraft 1.21.4를 사용하세요.

대규모 언어 모델과 마인플레이어 API 로 구동되는 마인크래프트 봇입니다. 이 봇은 모델 컨텍스트 프로토콜 (MCP)을 사용하여 클로드와 다른 지원 모델이 마인크래프트 캐릭터를 제어할 수 있도록 합니다.

필수 조건

• 노드.js
• 실행 중인 Minecraft 게임(아래 설정은 Microsoft Game Pass에 포함된 Minecraft 1.21.4 Java Edition으로 테스트되었습니다)
• 클로드 데스크탑

시작하기

이 봇은 MCP(Model Context Protocol)를 통해 Claude Desktop과 함께 사용하도록 설계되었습니다.

마인크래프트를 실행하세요

싱글 플레이어 세계를 만들고 LAN에 연결합니다( ESC -> Open to LAN ). 봇은 포트 25565 와 호스트 이름 localhost 사용하여 연결을 시도합니다. 이러한 매개변수는 다음 단계에서 claude_desktop_config.json 파일에서 설정할 수 있습니다.

MCP 구성

Claude Desktop이 설치되어 있는지 확인하세요. File -> Settings -> Developer -> Edit Config 엽니다. 설치 디렉터리가 열립니다. claude_desktop_config.json 파일을 찾아 다음 코드를 삽입하세요.

지엑스피1

--port 및 --host 매개변수가 올바르게 사용되었는지 다시 한번 확인하세요. Claude Desktop 애플리케이션을 완전히 재부팅하세요(OS 트레이에서 닫아야 함).

달리기

Minecraft 게임이 실행 중이고 월드가 LAN에 연결되어 있는지 확인하세요. 그런 다음 Claude Desktop 애플리케이션을 실행하면 봇이 게임에 참여할 수 있습니다.

Claude Desktop이 MCP 서버를 부팅하는 데 시간이 걸릴 수 있습니다. 서버가 성공적으로 부팅되었음을 나타내는 망치 아이콘이 채팅 옆에 표시됩니다.

활성화된 Claude Desktop 채팅을 통해 봇에게 명령을 내릴 수 있습니다. 건물 이미지를 업로드하여 봇에게 건설을 요청할 수도 있습니다 😁

프롬프트에 봇이 마인크래프트에서 무언가를 해야 한다는 것을 언급하는 것을 잊지 마세요. 이렇게 하면 MCP 서버를 실행하라는 메시지가 표시됩니다. 권한을 요청하게 됩니다.

Claude 3.7 Sonnet을 사용하면 흥미로운 결과를 얻을 수 있을 것 같습니다. 봇 에이전트가 정말 똑똑할 것 같네요 🫡

사용 예: 공유 Claude 채팅

사용 가능한 명령

Minecraft 서버에 연결되면 Claude는 다음 명령을 사용할 수 있습니다.

움직임

• get-position - 봇의 현재 위치를 가져옵니다
• move-to-position - 특정 좌표로 이동
• look-at - 봇이 특정 좌표를 바라보도록 합니다.
• jump - 봇을 점프하게 만듭니다
• move-in-direction - 특정 방향으로 일정 시간 동안 이동

목록

• list-inventory - 봇의 인벤토리에 있는 모든 아이템을 나열합니다.
• find-item - 인벤토리에서 특정 아이템 찾기
• equip-item - 특정 아이템 장착

블록 상호 작용

• place-block - 지정된 좌표에 블록을 배치합니다.
• dig-block - 지정된 좌표에 블록을 파기합니다.
• get-block-info - 블록에 대한 정보를 가져옵니다
• find-block - 특정 유형의 가장 가까운 블록을 찾습니다

엔티티 상호 작용

• find-entity - 특정 유형의 가장 가까운 엔터티 찾기

의사소통

• send-chat - 게임 내에서 채팅 메시지 보내기

기여하다

이 애플리케이션은 단 이틀 만에 만들어졌고, 코드는 정말 간단하고 직관적입니다. 모든 리팩토링 커밋, 기능 및 테스트 기여, 이슈 및 토론에 진심으로 감사드립니다!

개선을 위해 풀 리퀘스트를 제출하거나 이슈를 열어주세요. 개선이 필요한 부분은 다음과 같습니다.

• 추가 문서
• 더욱 강력한 오류 처리
• 다양한 구성 요소에 대한 테스트
• 새로운 기능 및 명령