Minecraft Remote

MCP Minecraft Remote

このプロジェクトは、arjunkmrm による mcp-minecraft に着想を得ています。元のプロジェクトはローカルの Minecraft サーバーへの接続のみをサポートしていましたが、リモート Minecraft サーバーへの接続をサポートするため、このプロジェクトを一から新たに作成しました。

MCP（Model Context Protocol）を使用した Minecraft のリモート操作。

機能

• AI アシスタントを介して Minecraft のプレイヤーに接続し、操作します
• Minecraft の世界を移動し、採掘、建築、インタラクションを行います
• サーバー上のほかのプレイヤーとチャットします
• インベントリ、プレイヤーの位置、サーバー情報を確認します
• ジャンプ、スニーク、スプリントなどの高度な移動操作を行います
• 攻撃や追従など、エンティティとインタラクションします
• コンテナ（チェスト、かまどなど）を使用します
• アイテムをクラフトし、村人と取引します
• インベントリを詳細に管理します

インストール

Smithery 経由でインストール

Smithery 経由で Claude Desktop 用の Minecraft Remote Control を自動的にインストールするには：

npx -y @smithery/cli install @nacal/mcp-minecraft-remote --client claude

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

npx -y @smithery/cli install mcp-minecraft-remote --client claude

CLI のプロンプトに従ってセットアップを完了してください。

手動インストール

# Install from npm
npm install -g mcp-minecraft-remote

# Or clone the repository
git clone https://github.com/nacal/mcp-minecraft-remote.git
cd mcp-minecraft-remote

# Install dependencies
npm install

# Build the project
npm run build

使い方

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 の設定を追加します：

{
  "mcpServers": {
    "minecraft-remote": {
      "command": "npx",
      "args": ["-y", "mcp-minecraft-remote@latest"]
    }
  }
}

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

{
  "mcpServers": {
    "minecraft-remote": {
      "command": "mcp-minecraft-remote"
    }
  }
}

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

{
  "mcpServers": {
    "minecraft-remote": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-minecraft-remote/build/index.js"]
    }
  }
}

3. ファイルを保存し、Claude Desktop を再起動します
4. Claude との新しい会話を開始し、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 で Minecraft サーバー play.example.com に接続してください」
• 「ゲーム内での現在位置を教えてください」
• 「座標 x=100, y=64, z=-200 に移動してください」
• 「3 秒間前に歩かせてください」
• 「ジャンプして、あの山に向かってダッシュしてください」

インベントリとアイテム

• 「インベントリの中身を詳しく確認してください」
• 「ダイヤモンドの剣を手に装備してください」
• 「インベントリから土ブロックを 5 個投げてください」

ブロックの操作

• 「座標 x=10, y=65, z=20 のブロックを掘ってください」
• 「座標 x=11, y=65, z=20 に石ブロックを置いてください」

エンティティとのやり取り

• 「近くにほかのプレイヤーはいますか？」
• 「自分から 20 ブロック以内にいるエンティティを教えてください」
• 「ID 12345 のゾンビを攻撃してください」
• 「Steve という名前のプレイヤーについていってください」

コンテナの使用

• 「座標 x=100, y=64, z=200 のチェストを開いてください」
• 「チェストから鉄インゴットを 10 個取ってください」
• 「チェストに丸石を 5 個入れてください」
• 「コンテナを閉じてください」

クラフトと取引

• 「木のツルハシを作るために利用できるレシピを教えてください」
• 「インベントリにある木材を使って棒を 4 本クラフトしてください」
• 「近くの村人がどんな取引を提供しているか確認してください」
• 「村人と取引してエメラルドを 10 個手に入れてください」

コミュニケーション

• 「チャットにこんにちはと送信してください」
• 「ダイヤモンドを見つけたとみんなに伝えてください」

必要条件

• Node.js 18+
• MCP に対応した AI アシスタント（Claude など）
• Minecraft Java Edition サーバー（バージョン 1.8 以降）

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

ライセンス

MIT