minecraft -pixel

MinecraftBuildMCP is an MCP server that lets Claude (or other compatible LLMs) control a Mineflayer-based Minecraft bot. Once running, you can connect via an MCP client and issue structured commands to move, place blocks, chat, inspect the world, and even generate pixel art. The available tools cover movement, inventory management, block interaction, entity detection, chat, and a dedicated pixel art builder, all designed to operate within a Minecraft world (preferably in Creative mode for easier testing).

To use it, start the local bot with the provided Node.js entry point and connect your MCP client (Claude Desktop or another client) using the configured host and port. The CLI options supported by the bot include host, port, and username to control the in-game bot identity. Once connected, you can issue commands like get-position, move-to-position, place-block, find-entity, send-chat, and build-pixel-art. The pixel art feature expects a 2D array of block types, an origin, and a direction, and will translate that into block placements in the world.

Prerequisites:

• Node.js v16 or higher
• Git
• A Minecraft Java Edition setup (world for testing; Creative mode recommended)

Installation steps:

1. Clone the repository: git clone https://github.com/Jeremy-Min-Yang/minecraft-mcp-server-pixel.git cd minecraft-mcp-server-pixel

2. Install dependencies: npm install

3. Build the project (if a build step exists): npm run build

4. Run the server locally using Node.js (as shown in the README examples): node dist/bot.js --host localhost --port 25565 --username Bob_the_Builder

5. Optional: Run via npx to test directly from GitHub (as shown in the README): npx -y github:Jeremy-Min-Yang/minecraft-mcp-server-pixel --host localhost --port 25565 --username Bob_the_Builder

Tips and considerations:

• Ensure Minecraft is running a compatible version (1.21.4 as tested) and that the world is accessible from the bot (LAN/port opening as needed).
• Creative mode is recommended for easier testing and teleport/inventory manipulation features.
• The server uses Mineflayer under the hood; refer to Mineflayer docs for bot capabilities and limitations.
• If you plan to run the MCP server in production, consider setting environment variables for production mode and securing the connection between the MCP client and the bot.
• When using npx/github references, you may need network access to fetch the package on first run.