Minecraft MCP Server

Minecraft MCP サーバー

---

重要

現在、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 のキャラクターを操作できるようにします。

前提条件

• Git
• 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 がインストールされていることを確認してください。File -> Settings -> Developer -> Edit Config を開きます。インストールディレクトリが開くはずです。claude_desktop_config.json という名前のファイルを見つけて、次のコードを挿入します。

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

--port と --host のパラメーターが正しく設定されていることを再確認してください。Claude Desktop アプリケーションを完全に再起動してください（OS のトレイで終了している必要があります）。

実行

Minecraft ゲームが起動していて、ワールドが LAN に公開されていることを確認してください。その後、Claude Desktop アプリケーションを起動すると、ボットがゲームに参加します。

Claude Desktop が MCP サーバーを起動するまで、しばらく時間がかかることがあります。サーバーが正常に起動したことを示すマーカーは次のとおりです。

Claude Desktop でアクティブなチャットを開けば、どれでもボットにコマンドを送れます。建物の画像をアップロードして、ボットに建築を頼むこともできます 😁

プロンプトでは、Minecraft で何かするようボットに指示することを忘れないでください。これが MCP サーバーを起動するトリガーになります。ボットから許可を求められます。

Claude Sonnet を使うと、興味深い結果が得られることがあります。ボットエージェントはとても賢いです 🫡

使用例：Claude の共有チャット

利用可能なコマンド

Minecraft サーバーに接続すると、Claude は次のコマンドを使用できます。

移動

• get-position - ボットの現在位置を取得します
• move-to-position - 指定した座標へ移動します
• look-at - ボットを指定した座標の方に向かせます
• jump - ボットをジャンプさせます
• move-in-direction - 指定した方向へ、指定した時間だけ移動します

飛行

• fly-to - ボットを指定した座標へ直接飛行させます

インベントリ

• list-inventory - ボットのインベントリ内のすべてのアイテムを一覧表示します
• find-item - インベントリ内の特定のアイテムを検索します
• equip-item - 特定のアイテムを装備します

ブロック操作

• place-block - 指定した座標にブロックを設置します
• dig-block - 指定した座標のブロックを掘ります
• get-block-info - ブロックに関する情報を取得します
• find-blocks - 特定の種類の近くにあるブロックを1つ以上検索します

かまど

• smelt-item - かまどのようなブロックを使ってアイテムを精錬します

エンティティ操作

• find-entity - 特定の種類の最も近くにいるエンティティを検索します

コミュニケーション

• send-chat - ゲーム内でチャットメッセージを送信します
• read-chat - プレイヤーからの最近のチャットメッセージを取得します

ゲームの状態

• detect-gamemode - ゲームのゲームモードを検出します

貢献

改善のためのプルリクエストやイシューをお気軽にお寄せください。リファクタリングのコミット、機能やテストに関する貢献、イシュー、ディスカッションをすべて大歓迎します！

貢献を始めるには、CONTRIBUTING.mdをご覧ください。

---

⭐ このプロジェクトが役に立った場合は、GitHubでスターを付けていただけると幸いです！ ⭐

皆さまのご支援により、このプロジェクトがより多くの人に知られ、役立てていただけます。