mcp-minecraft

Minecraft MCP サーバー

⚠️重要な互換性に関する警告：2025年3月25日現在、Minecraft 1.21.5がリリースされました。このボットは現在Minecraft 1.21.5と互換性がありません。1.21.5をサポートするアップデートがリリースされるまで、Minecraft 1.21.4をご利用ください。

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

大規模言語モデルとMineflayer APIを搭載したMinecraftボット。このボットは、モデルコンテキストプロトコル（MCP）を使用して、Claudeやその他のサポートされているモデルがMinecraftキャラクターを制御できるようにします。

前提条件

• ギット
• Node.js
• 実行中の Minecraft ゲーム (以下のセットアップは、Microsoft Game Pass に含まれる Minecraft 1.21.4 Java Edition でテストされています)
• クロードデスクトップ

はじめる

このボットは、モデル コンテキスト プロトコル (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という名前のファイルを見つけ、以下のコードを挿入してください。

--portおよび--hostパラメータが正しく使用されているか再度確認してください。Claude デスクトップアプリケーションを完全に再起動してください（OS トレイで閉じられているはずです）。

ランニング

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

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

アクティブなClaude Desktopチャットからボットにあらゆるコマンドを送ることができます。建物の画像をアップロードして、ボットに建ててもらうこともできます😁

プロンプトで、ボットがMinecraft内で何かを行う必要があることを忘れずに指定してください。これはMCPサーバーを起動するトリガーとなるため、許可を求められます。

Claude 3.7 Sonnetを使うと、興味深い結果が得られるかもしれません。ボットエージェントは本当に賢くなるでしょう🫡

使用例:共有されたクロードチャット

利用可能なコマンド

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-block - 特定のタイプの最も近いブロックを検索します

エンティティインタラクション

• find-entity - 特定のタイプの最も近いエンティティを検索する

コミュニケーション

• send-chat - ゲーム内でチャットメッセージを送信する

貢献

このアプリケーションはわずか2日で作成され、コードは非常にシンプルで分かりやすいです。リファクタリングのコミット、機能およびテストへの貢献、問題解決、そして議論にご協力いただければ幸いです。

改善のためのプルリクエストや未解決の課題をお気軽にご提出ください。改善が必要な箇所は以下のとおりです。

• 追加ドキュメント
• より堅牢なエラー処理
• さまざまなコンポーネントのテスト
• 新しい機能とコマンド