⛏️ Minecraft MCPサーバー — AI搭載Minecraftエージェント

作成者: Soumyadeep (AI/MLリード)

これは何ですか？

これは、Model Context Protocol (MCP) を活用したMinecraft用AIエージェントです。MCP互換のAIクライアント（Claude Desktop、Cursor、Kiro、Windsurfなど）をMinecraftワールドに直接接続し、AIを完全に機能するゲーム内ボットに変身させます。

AIは移動、建築、クラフト、チャットができるだけでなく、単一のコマンドでスキーマファイルから構造物全体を即座に生成することも可能です。

Related MCP server: Renge Bot

✨ 新機能 — スキーマビルダー（目玉機能）

このフォークの最大の追加機能は、スキーマビルダーシステムです。これは、.schem / .schematic ファイルを使用して、大規模で複雑な構造物を数秒で構築できる3つの新しいMCPツールセットです。

AIが place-block を何百回も退屈に呼び出す（遅く、エラーが発生しやすく、間違いが多い）代わりに、以下の処理を行います：

1. バンドルされたスキーマファイルのライブラリを確認

2. ファイルを解析して、寸法とブロックを理解

3. /setblock コマンドのストリームをボット経由で送信し、クリエイティブモードで構造物全体を即座に構築 — インベントリもパスファインディングも不要で、失敗もありません

3つの新しいツール

サポートされている形式

AIによる使用方法

AIは常に最初にバンドルされたライブラリを確認するように指示されています。そのため、次のように伝えると：

"近くにバイキングの家を建てて"

AIは以下の手順を実行します：

1. list-schematics を呼び出す → viking-house1 を見つける

2. schematic-info("viking-house1") を呼び出す → 寸法を読み取る

3. build-schematic("viking-house1", x, y, z) を呼び出す → 即座に生成する

手動でのブロック配置は不要です。幻覚による形状の崩れもありません。人間が設計した本物の構造物が数秒で完成します。

🛠️ 全ツールリファレンス

移動

建築 (スキーマ)

ブロック

インベントリ & クラフト

エンティティ & チャット

🚀 セットアップガイド

前提条件

• Node.js ≥ 20.10.0

• Git

• Minecraft Java Edition (1.21.xでテスト済み)

• MCP互換AIクライアント (Claude Desktop, Cursor, Kiroなど)

ステップ 1 — クローン & インストール

git clone https://github.com/soumyadeo/minecraft-mcp-server.git
cd minecraft-mcp-server
npm install

ステップ 2 — ビルド

npm run build

これによりTypeScriptが dist/main.js にコンパイルされます。

ステップ 3 — スキーマファイルの追加 (推奨)

プロジェクトルートの schematics/ フォルダに .schem ファイルを配置します：

minecraft-mcp-server/
  schematics/
    smallhouse1.schem       ← already included
    viking-house1.schematic ← already included
    my-castle.schem         ← add your own!

AIは list-schematics を通じて自動的にそれらを発見します。

ステップ 4 — MCPクライアントの設定

Claude Desktop

File → Settings → Developer → Edit Config を開き、以下を追加します：

{
  "mcpServers": {
    "minecraft": {
      "command": "node",
      "args": [
        "C:\\path\\to\\minecraft-mcp-server\\dist\\main.js",
        "--host", "localhost",
        "--port", "25565",
        "--username", "ClaudeBot"
      ]
    }
  }
}

Cursor / VS Code (mcp.json)

{
  "mcpServers": {
    "minecraft": {
      "command": "node",
      "args": [
        "C:\\path\\to\\minecraft-mcp-server\\dist\\main.js",
        "--host", "localhost",
        "--port", "25565",
        "--username", "ClaudeBot"
      ],
      "type": "stdio"
    }
  }
}

C:\path\to\ を実際のPC上のパスに置き換えてください。

ステップ 5 — Minecraftの起動

1. Minecraft Java Edition を起動

2. シングルプレイヤーワールド を開くか作成

3. ESC → LANに公開 を押す

4. 表示されたポート番号（通常は 25565）をメモする

5. チャットでボットにオペレーター権限を付与：

   /op ClaudeBot

   ⚠️ スキーマビルダーが使用する /setblock コマンドを機能させるには、オペレーター権限が必須です。

ステップ 6 — AIクライアントの再起動 & テスト

MCPクライアントを完全に再起動します（必要に応じてシステムトレイから終了してください）。ボットが自動的にゲームに参加するはずです。

テスト用プロンプト：

"利用可能なスキーマを確認し、現在の位置にsmallhouseを建てて。"

📦 スキーマの追加

スキーマライブラリは単なるフォルダです。構造物を追加するには：

1. オンラインで .schem ファイルを探す：

   • Planet Minecraft — "schematic" で検索・フィルタリング

   • Minecraft-Schematics.com

   • ゲーム内でWorldEditの //copy + //schem save コマンドを使用

2. minecraft-mcp-server/schematics/ にファイルを配置

3. MCPサーバーを再起動

AIは即座にそれを認識します。コードの変更は不要です。

⚙️ サーバー引数

node dist/main.js --host localhost --port 25565 --username ClaudeBot

🏗️ アーキテクチャ

src/
  main.ts                   — MCP server entry point, tool registration
  bot-connection.ts         — Mineflayer bot lifecycle management
  tool-factory.ts           — MCP tool registration wrapper
  tools/
    schematic-tools.ts      — ★ Schematic builder (new)
    block-tools.ts          — Block placement & digging
    position-tools.ts       — Movement & pathfinding
    inventory-tools.ts      — Inventory management
    crafting-tools.ts       — Recipe lookup & crafting
    furnace-tools.ts        — Smelting
    entity-tools.ts         — Entity detection
    chat-tools.ts           — In-game chat
    flight-tools.ts         — Flight control
    gamestate-tools.ts      — Game mode detection
schematics/                 — Bundled schematic file library
  smallhouse1.schem
  viking-house1.schematic

主要ライブラリ：

• mineflayer — Minecraftボットフレームワーク

• prismarine-schematic — スキーマファイルパーサー

• mineflayer-pathfinder — パスファインディング

• @modelcontextprotocol/sdk — MCPサーバーSDK

yuniko-software/minecraft-mcp-server からフォークし、拡張しました。

🗺️ ロードマップ

• [ ] mode: "bot_place" — mineflayer-builder を使用したサバイバルモードでの物理的な建築

• [ ] @kleppe/litematic-reader による .litematic 形式のサポート

• [ ] search-and-build ツール — キーワードでスキーマを検索・ダウンロード

• [ ] run-builder-script — 手続き型ビルドスクリプト（ピラミッド、ドームなど）の実行

• [ ] チェスト & ストレージツール

• [ ] 村人取引ツール

• [ ] 戦闘 & サバイバルツール

🤝 貢献

プルリクエストを歓迎します！ガイドラインについては CONTRIBUTING.md を参照してください。

📄 ライセンス

MIT — LICENSE を参照

作成・拡張者: Soumyadip Debnath (AI/MLリード) オリジナルプロジェクト: Yuniko Software