---

[!重要] 現在、Minecraftバージョン1.21.11をサポートしています。新しいバージョンはこのMCPサーバーで動作しない場合がありますが、できるだけ早くサポートを追加します。

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

大規模言語モデルとMineflayer APIを搭載したMinecraftボットです。このボットはModel Context Protocol(MCP)を使用して、Claudeや他のサポートされているモデルがMinecraftキャラクターを制御できるようにします。

前提条件

• ギット
• Node.js(>= 20.10.0)
• 動作中のMinecraftゲーム(以下のセットアップはMicrosoft Game Passに含まれるMinecraft 1.21.8 Java Editionでテスト)
• MCP互換クライアント。例としてClaude Desktopを使用しますが、他のMCPクライアントもサポートされています

始める

このボットはModel Context Protocol(MCP)を通じてClaude Desktopと共に使用されるよう設計されています。

Minecraftを動かせ

シングルプレイヤーワールドを作成し、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