---

[! 중요] 현재 Minecraft 버전 1.21.11을 지원합니다. 최신 버전은 이 MCP 서버와 호환되지 않을 수 있으나, 가능한 한 빨리 지원을 추가할 예정입니다.

https://github.com/user-attachments/assets/6f17f329-3991-4bc7-badd-7cde9aacb92f

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

선수 조건

• git
• Node.js (>= 20.10.0)
• 실행 중인 마인크래프트 게임 (아래 설정은 Microsoft Game Pass에 포함된 마인크래프트 1.21.8 자바 에디션으로 테스트됨)
• MCP 호환 클라이언트. Claude Desktop을 예시로 사용하지만, 다른 MCP 클라이언트도 지원됩니다

시작

이 봇은 모델 컨텍스트 프로토콜(MCP)을 통해 Claude Desktop과 함께 사용하도록 설계되었습니다.

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

싱글플레이어 월드를 만들고 LAN으로 열어 (ESC -> Open to LAN). 봇은 포트 25565와 호스트명 localhost를 사용해 연결을 시도합니다. 이 매개변수들은 다음 단계에서 claude_desktop_config.json에서 설정할 수 있습니다.

MCP 구성

Claude Desktop이 설치되어 있는지 확인하세요.

Minecraft MCP Server

---

[!IMPORTANT] Currently supports Minecraft version 1.21.11. Newer versions may not work with this MCP server, but we will add support as soon as possible.

https://github.com/user-attachments/assets/6f17f329-3991-4bc7-badd-7cde9aacb92f

A Minecraft bot powered by large language models and Mineflayer API. This bot uses the Model Context Protocol (MCP) to enable Claude and other supported models to control a Minecraft character.

Prerequisites

• Git
• Node.js (>= 20.10.0)
• A running Minecraft game (the setup below was tested with Minecraft 1.21.8 Java Edition included in Microsoft Game Pass)
• An MCP-compatible client. Claude Desktop will be used as an example, but other MCP clients are also supported

Getting started

This bot is designed to be used with Claude Desktop through the Model Context Protocol (MCP).

Run Minecraft

Create a singleplayer world and open it to LAN (ESC -> Open to LAN). Bot will try to connect using port 25565 and hostname localhost. These parameters could be configured in claude_desktop_config.json on a next step.

MCP Configuration

Make sure that Claude Desktop is installed. Open File -> Settings -> Developer -> Edit Config. It should open installation directory. Find file with a name claude_desktop_config.json and insert the following code:

{
  "mcpServers": {
    "minecraft": {
      "command": "npx",
      "args": [
        "-y",
        "github:yuniko-software/minecraft-mcp-server",
        "--host",
        "localhost",
        "--port",
        "25565",
        "--username",
        "ClaudeBot"
      ]
    }
  }
}

Double-check that right --port and --host parameters were used. Make sure to completely reboot the Claude Desktop application (should be closed in OS tray).

Running