Minecraft 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クライアントもサポートされています

Related MCP server: MCP Server

はじめに

このボットは、Model Context Protocol (MCP) を通じて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アプリケーションを完全に再起動（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 - ゲームのゲームモードを検出する

貢献

改善のためのプルリクエストやIssueの作成を歓迎します。リファクタリングのコミット、機能やテストへの貢献、Issueや議論は非常に感謝されます！

貢献を始めるには、CONTRIBUTING.md を参照してください。

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

あなたのサポートは、このプロジェクトを他の必要としている人々に知ってもらう助けになります。