mc-mcp-server

mc-mcp-server

  claude opus5.5 build the castle

⛏️ Minecraft 用の Model Context Protocol サーバーです。

インストール

• maven

使い方

ボットは Minecraft Java Edition 1.21.7 サーバーにオフラインプレイヤーとして参加するため、 サーバーでは online-mode=false に設定する必要があります。ボットにコマンドを実行させる場合は、ボットに OP 権限を付与してください（/op LLMBot）。

java -cp ... vavi.games.minecraft.mcp.MinecraftBotMCP [-host localhost] [-port 25565] [-username LLMBot]

ツール

name	description
get-position	位置、ゲームモード、体力
move-to-position	経路探索を使って指定位置まで歩きます（歩行、段差を上る、飛び降り）
look-at	指定位置に向けて頭を回します
jump	ジャンプします
move-in-direction	指定時間、前／後／左／右に歩きます
list-inventory, find-item	インベントリの内容
equip-item	アイテムを手、オフハンド、または防具スロットに移動します
place-block	持っているブロックを設置します（必要に応じて設置可能な範囲まで歩きます）
dig-block	ブロックを掘ります。サバイバルではバニラの破壊時間がかかります
get-block-info, find-block	読み込み済みチャンクにあるボットのコピーから情報を取得します
find-entity	種類またはプレイヤー名で最も近いエンティティを検索します
send-chat	チャットを送信します。/ で始まる場合はコマンドとして実行し、サーバーの応答メッセージを返します
build-blocks	1 回の呼び出しでブロックのリストを設置します。アイテムを装備し、各ブロックを支えられる順序で設置し、設置可能な範囲まで歩き、高所には一時的な柱を作ります。再開可能です
fill-region	同じ方法で領域を埋めます（全面、空洞、または壁）
clear-region	領域を上から掘り崩します（任意で、原木など一致するブロックのみを対象にできます）。インベントリ内の最適な道具を使います
scan-area	計画用に、エリアの高さマップを取得します（任意で木を除外できます）

ボットは葉を掘って通り抜け、掘削には最適な道具（斧、ツルハシ、シャベル、クワ）を選びます。

ゲームデータ

src/main/resources/vavi/games/minecraft/mcp/{blocks.tsv,items.txt} は、バニラサーバーのデータレポート （java -DbundlerMainClass=net.minecraft.data.Main -jar server.jar --reports） と minecraft-data のブロック衝突形状から生成されます。 mcprotocollib のプロトコルバージョンが変更された場合は、再生成してください。

参考資料

• https://github.com/GeyserMC/MCProtocolLib
• https://github.com/modelcontextprotocol/java-sdk
• https://github.com/yuniko-software/minecraft-mcp-server

TODO