Minecraft MCP統合

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

スクリーンショット

前提条件

Minecraft ランチャー
Node.js 18以上
クロードデスクトップアプリ
Java 21.0.5（推奨）

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

重要な注意事項

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

フォーカス設定

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

インストール手順

Minecraft サーバーのダウンロードとセットアップ
- mcversions.net/1.21から Minecraft サーバー v1.21 をダウンロードします。
- Java 21.0.5 がまだインストールされていない場合はインストールしてください (他のバージョンはテストされていません)
- 専用のディレクトリを作成します（例： ~/minecraft-server/ ）
- ダウンロードしたserver.jarファイルをこのディレクトリに置きます
- server.jarファイルへの絶対パスを書き留めます。
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 パスに置き換えます
Claudeデスクトップを起動
- 設定が完了したらClaude Desktopを起動します
サーバーに接続
- 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

トラブルシューティング

よくある問題

MCP接続に失敗しました
- 残っているJavaプロセスを探す
- 手動で終了します:
  - Windows: タスクマネージャーを使用する (未テスト)
  - Mac/Linux:
    - 「アクティビティモニタ」と「強制終了」のJavaに移動します
- プロセスの終了に失敗した場合はコンピュータを再起動します
- 注: 最新バージョンではこれらの問題は自動的に解決されるはずです
サーバーが起動しない
- Javaがインストールされていることを確認する
- server.jar パスが正しいことを確認してください
- ポート25565が利用可能であることを確認する
サーバーに接続できません
- サーバーが実行中であることを確認する（ログをチェックする）
- サーバーアドレスとして「localhost」を使用していることを確認してください
- ファイアウォールの設定を確認する

ログの場所

Minecraft サーバーログ: minecraft-server ディレクトリを確認してください
Claude デスクトップログ: ~/Library/Logs/Claude/mcp*.log

貢献

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

ライセンス

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

mcp-minecraft