Minecraft

🚀 Minecraft MCP 統合

このプロジェクトは、Model Context Protocol (MCP) を Minecraft で統合し、AI アシスタントとサーバーの間のインタラクションを実現するものです。この統合により、AI モデルは Minecraft の世界を観察し、ロボットを通じてその世界とやり取りすることができます。

🚀 クイックスタート

このセクションでは、Minecraft MCP 統合を使用するための基本的な手順を説明します。

✨ 主な機能

• ロボット制御：MCP インターフェースを通じてゲーム内のキャラクターを制御できます。
• データ交換：ゲームと AI の間でリアルタイムデータをやり取りできます。
• スクリプトサポート：Node.js を使用してカスタムスクリプトを記述し、機能を拡張できます。

📦 インストール

前提条件

1. Minecraft 起動器
2. Node.js 18 以上のバージョン
3. Claude デスクトップアプリケーション
4. Java 21.0.5（推奨）

⚠️ 重要な注意

現在、この統合は macOS/Linux でのみテストされており、Windows での互換性は保証されていません。

インストール手順

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 に移動します。
   • 以下の内容をファイルに追加します：

     {
       "mcpIntegration": {
         "enabled": true,
         "serverPath": "/path/to/minecraft-server",
         "jarName": "server.jar"
       }
     }
     

   • Claude デスクトップアプリケーションを起動し、MCP 統合機能を有効にします。

3. インストールの確認

   • Java と Node.js が正しくインストールされていることを確認します。
   • server.jar ファイルが存在し、パスが正しいことを確認します。
   • Minecraft サーバーを起動して、正常に動作することを確認します。

重要な注意事項

1. F3+P ショートカットの使用： F3 と P を同時に押します。これにより、「フォーカスを失ったときに一時停止」機能が切り替わります。この機能を無効にすると、Claude デスクトップアプリケーションに戻り、Minecraft を一時停止することなく続行できます。

2. Claude 再起動時の接続問題： Minecraft サーバーが実行中に Claude を再起動すると、Java プロセスが残っているため、次回の MCP 接続が失敗することがあります。詳細な解決手順はよくある質問：MCP 接続失敗を参照してください。

💡 使用上のヒント

初回実行時には、追加の依存関係が必要になる場合があります。指示に従って必要なパッケージをインストールしてください。問題が発生した場合は、ログファイルを確認して詳細な情報を取得してください。

📚 ドキュメント

よくある質問

1. サーバーに接続できない場合

• Minecraft サーバーが実行中であることを確認してください。
• サーバーアドレスとして "localhost" を使用していることを確認してください。
• ファイアウォール設定を確認し、ポート 25565 が使用可能であることを確認してください。

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

• Java がインストールされていることを確認してください。
• server.jar のパスが正しいことを確認してください。
• ポート 25565 が他のアプリケーションによって使用されていないことを確認してください。

3. Java プロセスが終了しない場合

• Mac/Linux では、jps コマンドを使用して Java プロセスを見つけます。
• タスクマネージャー（Windows）またはアクティビティモニター（Mac/Linux）を使用してプロセスを強制終了します。
• 手動で終了できない場合は、コンピューターを再起動してください。

ログの場所

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

🤝 貢献

小さな貢献でも大歓迎です！

📄 ライセンス

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