Minecraft MCP統合

Minecraft 向けの Model Context Protocol (MCP) 統合により、AI アシスタントが Minecraft サーバーとやり取りできるようになります。この統合により、AI モデルはボットを介して Minecraft の世界を観察し、やり取りできるようになります。

前提条件

1. Minecraft ランチャー

2. Node.js 18以上

3. クロードデスクトップアプリ

4. Java 21.0.5（推奨）

⚠️ 注意: 現在、macOS/Linux でのみテストされています。Windows との互換性は保証されません。

Related MCP server: MCP Minecraft Remote

重要な注意事項

1. F3+P ショートカットを使う：F3 + P を同時に押してください。「フォーカスが失われたときに一時停止」機能がオン/オフになります。オフにすると、claude デスクトップに切り替えても Minecraft は一時停止せずに起動し続けます。

2. Claude 再起動時の接続問題: Minecraft サーバーの実行中に Claude を再起動すると、Java プロセスが残っているため、次回の Claude 起動時に MCP 接続の問題が発生する可能性があります。解決手順については、 「トラブルシューティング: MCP 接続失敗」を参照してください。

インストール手順

1. Minecraft サーバーのダウンロードとセットアップ

   • mcversions.net/1.21から Minecraft サーバー v1.21 をダウンロードします。

   • Java 21.0.5 がまだインストールされていない場合はインストールしてください (他のバージョンはテストされていません)

   • 専用のディレクトリを作成します（例： ~/minecraft-server/ ）

   • ダウンロードしたserver.jarファイルをこのディレクトリに置きます

   • server.jarファイルへの絶対パスを書き留めます。

2. MCP統合のインストールと構成

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

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

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

   または手動設定:

   • ~/Library/Application Support/Claude/claude_desktop_config.jsonに移動します。

   • MCP サーバー構成を追加します。

   {
     "mcpServers": {
       "mcp-minecraft": {
         "command": "npx",
         "args": [
           "-y",
           "mcp-minecraft@latest",
           "--server-jar",
           "/absolute/path/to/minecraft-server/server.jar"
         ]
       }
     }
   }   

   ⚠️ /absolute/path/to/minecraft-server/server.jarを実際の server.jar パスに置き換えます

3. Claudeデスクトップを起動

   • 設定が完了したらClaude Desktopを起動します

4. サーバーに接続

   • Minecraftランチャーを開く

   • Minecraft Java Edition v1.21をインストールして起動します

   • 「プレイ」をクリックし、「マルチプレイヤー」を選択します

   • 「サーバーを追加」をクリックします

   • サーバーの詳細を入力してください:

     • サーバー名: Minecraft Server

     • サーバーアドレス: localhost:25565

   • 「完了」をクリック

特徴

リソース

統合により、次の MCP リソースが公開されます。

• minecraft://bot/location - ワールド内の現在のボットの位置

• minecraft://bot/status - ボットの接続ステータス

ツール

利用可能な MCP ツール:

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

• jump - ボットをジャンプさせる

• moveForward - ボットを前進させる

• moveBack - ボットを後方に移動させる

• turnLeft - ボットを左に旋回させる

• turnRight - ボットを右に曲がらせる

• placeBlock - 指定された座標にブロックを配置する

• digBlock - 指定された座標でブロックを破壊する

• getBlockInfo - 指定された座標にあるブロックに関する情報を取得します

• selectSlot - ホットバーのスロットを選択する (0-8)

• getInventory - ボットのインベントリの内容を取得する

• equipItem - 指定した目的地に名前でアイテムを装備する

• getStatus - ボットの現在のステータス (健康、食料、位置など) を取得します

• getNearbyEntities - 範囲内の近くのエンティティのリストを取得します

• attack - 近くのエンティティを名前で攻撃する

• useItem - 現在保持しているアイテムを使用/アクティブ化する

• stopUsingItem - 現在のアイテムの使用を停止/非アクティブ化する

• lookAt - ボットに特定の座標を向けさせる

• followPlayer - 特定のプレイヤーをフォローする

• stopFollowing - 現在のターゲットのフォローを停止する

• goToPosition - 特定の座標に移動する

技術的な詳細

• ローカル開発のためにサーバーはオフラインモードで実行されます

• デフォルトのメモリ割り当て: 2GB

• デフォルトポート: 25565

• ボットのユーザー名: MCPBot

トラブルシューティング

よくある問題

1. MCP接続に失敗しました

   • 残っているJavaプロセスを探す

   • 手動で終了します:

     • Windows: タスク マネージャーを使用する (未テスト)

     • Mac/Linux:

       • 「アクティビティモニタ」と「強制終了」のJavaに移動します

   • プロセスの終了に失敗した場合はコンピュータを再起動します

   • 注: 最新バージョンではこれらの問題は自動的に解決されるはずです

2. サーバーが起動しない

   • Javaがインストールされていることを確認する

   • server.jar パスが正しいことを確認してください

   • ポート25565が利用可能であることを確認する

3. サーバーに接続できません

   • サーバーが実行中であることを確認する（ログをチェックする）

   • サーバーアドレスとして「localhost」を使用していることを確認してください

   • ファイアウォールの設定を確認する

ログの場所

• Minecraft サーバーログ: minecraft-server ディレクトリを確認してください

• Claude デスクトップ ログ: ~/Library/Logs/Claude/mcp*.log

貢献

規模の大小を問わず、寄付を歓迎します。

ライセンス

このプロジェクトは MIT ライセンスに基づいてライセンスされています - 詳細についてはLICENSEファイルを参照してください。