mcp-minecraft

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 との互換性は保証されません。

重要な注意事項

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ファイルを参照してください。