MCP マインクラフト リモート

このプロジェクトは、arjunkmrmによるmcp-minecraftにインスピレーションを得ています。オリジナルのプロジェクトはローカルのMinecraftサーバーへの接続のみをサポートしていましたが、このプロジェクトはリモートのMinecraftサーバーへの接続をサポートするために、ゼロから新たに作成されました。

MCP (モデル コンテキスト プロトコル) を使用した Minecraft リモート コントロール。

特徴

• AIアシスタントを介してMinecraftプレイヤーに接続して制御する

• Minecraft の世界を探索、採掘、構築、そしてインタラクトしましょう

• サーバー上の他のプレイヤーとチャットする

• インベントリ、プレイヤーの位置、サーバー情報を確認する

• ジャンプ、忍び寄り、ダッシュなどの高度な移動制御

• 攻撃や追跡を含むエンティティの相互作用

• コンテナの使用（チェスト、かまどなど）

• アイテムの作成と村人との取引

• 詳細な在庫管理

インストール

クイックインストール（推奨）

CLI プロンプトに従ってセットアップを完了します。

手動インストール

使用法

Claude Desktopでの使用

1. Claude Desktop 構成ファイルに移動します。

   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Minecraft Remote MCP 構成を構成ファイルに追加します。

グローバルにインストールした場合:

リポジトリをローカルにクローンした場合:

3. ファイルを保存し、Claude Desktopを再起動します。

4. クロードと新しい会話を開始し、Minecraftコントロールコマンドの使用を開始します

重要なサーバー要件

• サーバーのオンラインモード：Minecraftサーバーのserver.propertiesファイルでonline-mode=falseを設定する必要があります。これにより、ボットはMinecraftのセッションサーバーに認証なしで接続できるようになります。

• 認証付きのサーバーを使用する場合は、接続時に有効なプレミアム アカウントの資格情報を提供する必要があります。

利用可能なツール

コア機能

• connectToServer : 指定された資格情報でMinecraftサーバーに接続する

• disconnectFromServer : Minecraft サーバーから切断します

• sendChat : チャットメッセージをサーバーに送信する

• getServerInfo : 接続されたサーバーに関する情報を取得します

動き

• getPosition : 現在のプレーヤーの位置を取得する

• moveTo : 特定の座標に移動する

• moveControl : 基本的な移動コントロール (前進、後退、左、右、ジャンプ、ダッシュ、スニーク、停止)

• lookAt : プレイヤーを特定の方向または座標に向ける

世界との交流

• digBlock : 特定の座標でブロックを採掘する

• placeBlock : 特定の座標にブロックを配置する

在庫管理

• checkInventory : 基本的な在庫チェック

• inventoryDetails : 在庫品目の詳細情報を取得します

• equipItem : インベントリからアイテムを手または鎧のスロットに装備する

• tossItem : インベントリからアイテムを投げる

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

• getNearbyPlayers : 近くのプレイヤーのリストを取得する

• getNearbyEntities : 近くにあるすべてのエンティティのリストを取得します

• attackEntity : 特定のエンティティを攻撃する

• useOnEntity : 特定のエンティティで保持されているアイテムを使用する

• followEntity : 特定のエンティティをフォローする

コンテナインタラクション

• openContainer : 特定の座標にあるコンテナ（チェスト、かまどなど）を開く

• withdrawItem : 開いているコンテナからアイテムを取り出す

• depositItem : 開いたコンテナにアイテムを入れる

• closeContainer : 現在開いているコンテナを閉じる

クラフト

• getRecipes : 利用可能なクラフトレシピのリストを取得します

• craftItem : 利用可能な材料を使ってアイテムを作成する

トレーディング

• listTrades : 近くの村人から利用可能な取引を一覧表示する

• tradeWithVillager : 近くの村人と取引する

プロンプトの例

基本操作

• 「ユーザー名 player1 で play.example.com の Minecraft サーバーに接続します」

• 「ゲーム内での私の現在の位置は？」

• 「座標 x=100、y=64、z=-200 に移動してください」

• 「3秒間前へ歩かせてください」

• 「あの山に向かってジャンプして走らせてください」

在庫とアイテム

• 「在庫内容を詳しく確認する」

• 「ダイヤモンドの剣を手に装備してください」

• 「インベントリから土ブロックを5つ投げる」

ブロックインタラクション

• 「座標 x=10、y=65、z=20 のブロックを掘る」

• 「座標 x=11、y=65、z=20 に石ブロックを配置します」

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

• 「近くに他のプレイヤーはいますか？」

• 「私から20ブロック以内にはどんな存在がいるのか？」

• 「ID 12345のゾンビを攻撃する」

• 「スティーブというプレイヤーをフォローする」

コンテナの使用

• 「座標 x=100、y=64、z=200 の宝箱を開ける」

• 「宝箱から鉄のインゴットを10個取り出す」

• 「宝箱に丸石を5つ入れる」

• 「容器を閉じてください」

クラフトと取引

• 「木製のツルハシを作るためのレシピは何ですか？」

• 「在庫にある木材を使って棒を4本作る」

• 「近くの村人がどんな取引をしているか確認する」

• 「村人と取引してエメラルド10個をゲット」

コミュニケーション

• 「チャットにHelloメッセージを送信」

• 「ダイヤモンドを見つけたとみんなに伝えて」

要件

• Node.js 18歳以上

• MCPをサポートするAIアシスタント（Claudeなど）

• Minecraft Java Edition サーバー (バージョン 1.8 以降)

注：このツールは、Minecraft 1.21のバニラバージョンでのみ動作することをテストおよび検証済みです。他のバージョンやMODサーバーでも動作する可能性がありますが、互換性は保証されません。

ライセンス

マサチューセッツ工科大学