MCP Minecraft Remote

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サーバーでも動作する可能性がありますが、互換性は保証されません。

ライセンス

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