Minecraft

🚀 Minecraft MCP サーバー

大型言語モデルとMineflayer APIによって駆動されるMinecraftボットです。このボットは、モデルコンテキストプロトコル（MCP）を通じてClaudeや他のサポートされるモデルがMinecraftのキャラクターを制御できるようにします。

⚠️ 重要な互換性警告

2025年3月25日現在、Minecraft 1.21.5が新たにリリースされました。このボットは現在、Minecraft 1.21.5と互換性がありません。1.21.5をサポートするアップデートがリリースされるまで、Minecraft 1.21.4を使用してください。

🚀 クイックスタート

📦 インストール

前提条件

• Node.js
• 実行中のMinecraftゲーム（以下の設定は、Microsoft Game Passに含まれるMinecraft 1.21.4 Java版でテストされています）
• Claude Desktop

💻 使用例

Minecraftの起動

単一プレイヤーのワールドを作成し、それをLANに公開します（ESC -> LANゲームを開く）。ボットはポート25565とホスト名localhostに接続しようとします。これらのパラメータは、次の手順でclaude_desktop_config.jsonに設定できます。

MCPの設定

Claude Desktopがインストールされていることを確認してください。ファイル -> 設定 -> 開発者 -> 設定を編集を開くと、インストールディレクトリが開きます。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アプリケーションを完全に再起動してください（オペレーティングシステムのトレイで閉じる必要があります）。

実行

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

Claude DesktopがMCPサーバーを起動するのに少し時間がかかる場合があります。サーバーが正常に起動したことの目印は、チャットの横にハンマーアイコンが表示されることです。

Claude Desktopのアクティブなチャットを通じて、ボットにコマンドを送信できます。また、建物の画像をアップロードしてボットに建造させることもできます 😁

ボットにMinecraft内で何らかの操作を実行するように指示する際は、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 - 指定された座標のブロックを掘る
• break-block - 指定された座標のブロックを破壊
• get-block - 指定された座標のブロックの情報を取得

その他

• help - 利用可能なコマンドのリストを表示
• stop - ボットを停止する

🤝 貢献

改善のためのプルリクエストの送信や問題の報告を歓迎します。以下は改善できるいくつかの分野です。

• より詳細なドキュメント
• より強力なエラー処理
• 異なるコンポーネントのテスト
• 新しい機能やコマンド