MinecraftBuildMCP

MinecraftBuildMCP

MinecraftBuildMCP は、Mineflayer API を使用して Claude（またはほかの互換性のある LLM）が Minecraft のボットを操作できるようにする、Model Context Protocol（MCP）サーバーです。このプロジェクトは AI 言語モデルと Minecraft の間をつなぎ、自然言語を通じて Minecraft の世界での建築、探索、操作を自動化できるようにします。

🌟 特長

• AI によるボット操作：Claude Desktop から Minecraft を直接操作できます
• ピクセルアートの作成：複雑なピクセルアートのデザインを自動で構築できます
• ナビゲーション：Minecraft の世界を簡単に移動できます
• ブロックの設置：指定した座標にブロックを正確に設置できます
• エンティティの検出：エンティティを見つけ、環境とやり取りできます
• ゲーム内チャット：チャットメッセージを送受信できます
• クリエイティブモードのサポート：テレポートやインベントリ操作など、クリエイティブモード向けの特別な機能を利用できます

📋 前提条件

• Node.js v16 以降
• Minecraft Java Edition（バージョン 1.21.4 でテスト済み）
• Claude Desktop（または互換性のある MCP クライアント）

🔧 インストール

1. リポジトリをクローンし、依存関係をインストールします：

   git clone https://github.com/Jeremy-Min-Yang/minecraft-mcp-server-pixel.git
   cd minecraft-mcp-server-pixel
   npm install
   

2. プロジェクトをビルドします：

   npm run build
   

🚀 ボットの実行

1. Minecraft を起動し、ワールドを LAN に公開します：

   • Minecraft 1.21.4 を起動します
   • 新しいワールドを作成するか、既存のワールドを開きます
   • 最良の結果を得るには、クリエイティブモードを使用してください
   • Esc キーを押して、「LAN に公開」をクリックします
   • チートを有効にして、ゲームモードを設定します
   • 「LAN ワールドを開始」をクリックし、ポート番号を控えます

2. ボットをローカルで実行します：

   node dist/bot.js --host localhost --port 25565 --username Bob_the_Builder
   

   または、npx を使って GitHub から直接実行します：

   npx -y github:Jeremy-Min-Yang/minecraft-mcp-server-pixel --host localhost --port 25565 --username Bob_the_Builder
   

3. コマンドラインオプション：

   • --host：Minecraft サーバーのホスト名（デフォルト：localhost）
   • --port：Minecraft サーバーのポート（デフォルト：25565）
   • --username：ボットのユーザー名（デフォルト：Bob_the_Builder）

🔌 Claude Desktop との統合

Minecraft MCP サーバーを有効にするには、claude_desktop_config.json に以下を追加します：

{
  "mcpServers": {
    "minecraft": {
      "command": "npx",
      "args": [
        "-y",
        "github:Jeremy-Min-Yang/minecraft-mcp-server-pixel",
        "--host",
        "localhost",
        "--port",
        "25565",
        "--username",
        "Bob_the_Builder"
      ]
    }
  }
}

🛠️ 利用可能なコマンド

接続すると、Claude は以下のコマンドを使って Minecraft のボットを操作できます：

移動

• get-position — ボットの現在位置を取得します
• move-to-position — 指定した座標に移動します（クリエイティブモードではテレポートします）

インベントリ

• equip-item — ボットの手にアイテムを装備します
• get-bot-status — 現在のゲームモードと OP ステータスを表示します
• list-block-names — この Minecraft バージョンで有効なブロック名をすべて一覧表示します

ブロックの操作

• place-block — 指定した座標にブロックを設置します

エンティティとの操作

• find-entity — 指定した種類の最も近いエンティティを見つけます

チャット

• send-chat — ゲーム内でチャットメッセージを送信します

ピクセルアート

• build-pixel-art — ブロックの種類を並べた 2D 配列からピクセルアート画像を構築します

🎨 ピクセルアートの例

ピクセルアートを作成するには、ブロックの種類を並べた 2D 配列、原点、方向を指定します：

// Example pixel art command
{
  "pixels": [
    ["wool_red", "wool_red", "wool_red"],
    ["wool_blue", "wool_white", "wool_blue"],
    ["wool_blue", "wool_blue", "wool_blue"]
  ],
  "origin": { "x": 100, "y": 64, "z": 100 },
  "direction": "north"
}

📚 ドキュメント

• API の詳細については、schema.md を参照してください
• 基盤となるボット API の詳細については、Mineflayer のドキュメントを参照してください：Mineflayer ドキュメント

🤝 貢献

貢献を歓迎します！お気軽に Pull Request を送信してください。

1. プロジェクトをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. Pull Request を作成します

📄 ライセンス

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

👏 謝辞

• Mineflayer - Minecraft ボットライブラリ
• Model Context Protocol - LLM をツールに接続するためのプロトコル
• Anthropic - Claude AI の開発元

---

AI を活用した開発をお楽しみください！🤖🏗️