minecraft-aiworld/CLAUDE.md

Minecraft AI World

This is a Claude Code workspace for interacting with a Minecraft Bedrock world via the mc-ai-bridge MCP server.

Connection

The mc-ai-bridge runs at 10.0.0.247:

• WebSocket (Minecraft → Bridge): port 3001
• MCP HTTP (Claude → Bridge): port 3002

To connect Minecraft Bedrock to the bridge, run this command in-game:

/connect 10.0.0.247:3001

Available MCP Tools

minecraft_command

Execute any slash command in Minecraft. Do NOT include the leading /.

• command (string): e.g. "give @p diamond 64", "tp @p 100 64 200", "time set night"

minecraft_chat

Send a chat message visible in Minecraft.

• message (string): The message to send
• player (string, optional): Target player for /tell. Omit to broadcast with /say.

minecraft_build

Execute a batch of build commands with rate limiting. Max 200 commands per call. Only setblock, fill, clone, and structure commands are allowed.

• commands (string[]): e.g. ["setblock 10 64 10 stone", "fill 10 64 10 20 64 20 glass"]

minecraft_get_events

Get recent game events from the in-memory event buffer.

• count (number, optional): Number of events to return (default 20, max 100)
• type (string, optional): Filter by event type, e.g. "PlayerMessage", "BlockChanged"

minecraft_get_status

Check if Minecraft is connected and get status info (player name, uptime, subscriptions, queue stats). No parameters.

minecraft_subscribe

Subscribe to Bedrock event types. Available events: PlayerMessage, BlockChanged, PlayerTransform, ItemUsed, ItemAcquired, ItemCrafted, MobKilled, MobInteracted, PlayerTravelled, PlayerDied, BossKilled

• event (string): Event type to subscribe to

Tips

• Always call minecraft_get_status first to verify Minecraft is connected before issuing commands.
• Subscribe to PlayerMessage to receive chat from the player.
• Use minecraft_build for multi-block constructions — it handles rate limiting automatically.
• Coordinates in Minecraft are (X, Y, Z) where Y is vertical height.