MinecraftBuildMCP

Name: MinecraftBuildMCP
Author: Jeremy-Min-Yang

@Jeremy-Min-Yang

代码仓库

关于 MinecraftBuildMCP

暂无概览

基本信息

分类

其他

许可证

MIT license

运行时

node

传输方式

stdio

发布者

Jeremy-Min-Yang

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "minecraft-mcp-server-pixel": {
      "command": "node",
      "args": [
        "dist/bot.js",
        "--host",
        "localhost",
        "--port",
        "25565",
        "--username",
        "Bob_the_Builder"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is MinecraftBuildMCP?

MinecraftBuildMCP is a Model Context Protocol (MCP) server that enables Claude (or other compatible LLMs) to control a Minecraft bot using the Mineflayer API. It bridges the gap between AI language models and Minecraft, allowing automated building, exploration, and interaction through natural language.

How to use MinecraftBuildMCP?

After installing Node.js v16+, clone the repository, run npm install and npm run build. Start Minecraft Java Edition 1.21.4, open a world to LAN, and note the port. Run the bot with node dist/bot.js --host localhost --port 25565 --username Bob_the_Builder. Alternatively, use npx -y github:Jeremy-Min-Yang/minecraft-mcp-server-pixel --host localhost --port 25565 --username Bob_the_Builder. Then add the corresponding MCP server configuration to your claude_desktop_config.json.

Key features of MinecraftBuildMCP

AI-powered bot control via natural language
Automated pixel art creation from 2D arrays
Movement and navigation commands
Precise block placement at specified coordinates
Entity detection and interaction
In-game chat send and receive
Creative mode support including teleportation and inventory manipulation

Use cases of MinecraftBuildMCP

Build complex pixel art designs automatically using natural language prompts
Automate exploration and navigation of Minecraft worlds
Interact with the environment and entities without manual control
Create automated building workflows for large structures
Enable AI-assisted creative mode building with inventory management

FAQ from MinecraftBuildMCP

What is MinecraftBuildMCP and how does it work?

MinecraftBuildMCP is an MCP server that connects LLMs like Claude to a Minecraft bot (powered by Mineflayer). It exposes commands for movement, block placement, entity detection, chat, and pixel art, allowing the AI to control the bot based on natural language instructions.

What are the prerequisites to run MinecraftBuildMCP?

You need Node.js v16 or higher, Minecraft Java Edition (tested on version 1.21.4), and a compatible MCP client such as Claude Desktop. Creative Mode is recommended for full functionality.

How do I integrate MinecraftBuildMCP with Claude Desktop?

Add the following entry to your claude_desktop_config.json under mcpServers: a key named "minecraft" with command npx, arguments including -y, the GitHub repository URL, and options for host, port, and username. Full example is in the README.

What commands can I use to control the bot?

Available commands include get-position, move-to-position, equip-item, get-bot-status, list-block-names, place-block, find-entity, send-chat, and build-pixel-art. Each command has specific parameters detailed in the project's schema documentation.

Does MinecraftBuildMCP support creative mode features?

Yes. Creative mode offers teleportation via move-to-position and full inventory manipulation. The recommended configuration uses Creative Mode for the best experience.