Minecraft MCP Server logo

Minecraft MCP Server

by yuniko-software

A Minecraft bot powered by large language models and the Mineflayer API. It uses the Model Context Protocol (MCP) to enable Claude and other supported models to control a Minecraft character.

View on GitHub

Last updated: N/A

What is Minecraft MCP Server?

This is a Minecraft bot that allows large language models like Claude to control a Minecraft character using the Model Context Protocol (MCP) and the Mineflayer API.

How to use Minecraft MCP Server?

  1. Run Minecraft in singleplayer and open it to LAN. 2. Configure Claude Desktop with the provided MCP server settings in claude_desktop_config.json. 3. Ensure the Minecraft game is running and the world is opened to LAN. 4. Start Claude Desktop, and the bot should join the game. 5. Give commands to the bot through any active Claude Desktop chat, mentioning that the bot should do something in Minecraft.

Key features of Minecraft MCP Server

  • LLM-powered Minecraft control

  • Integration with Claude Desktop via MCP

  • Uses Mineflayer API for Minecraft interaction

  • Supports various commands for movement, inventory, block interaction, entity interaction, and communication

Use cases of Minecraft MCP Server

  • Automated building and resource gathering

  • AI-driven exploration and task completion

  • Interactive gameplay with LLM-controlled characters

  • Educational tool for learning about AI and Minecraft

  • Experimenting with AI agents in a virtual environment

FAQ from Minecraft MCP Server

What Minecraft version is supported?

The bot is tested with Minecraft 1.21.4 Java Edition. Check the README for compatibility with newer versions.

What is MCP?

MCP stands for Model Context Protocol. It enables Claude and other supported models to control a Minecraft character.

How do I configure Claude Desktop?

Open File -> Settings -> Developer -> Edit Config in Claude Desktop and insert the provided code into claude_desktop_config.json.

Why is the bot not connecting?

Double-check the --port and --host parameters in claude_desktop_config.json. Ensure Minecraft is running and the world is opened to LAN. Reboot Claude Desktop completely.

How do I give commands to the bot?

Give commands through any active Claude Desktop chat, mentioning that the bot should do something in Minecraft. For example, 'Bot, dig a block'.