OpenViSTAI · Agents · Blockchain · Crypto
Submit a project
Menu
MCP & Tooling

Minecraft MCP Server

Minecraft MCP Server is an open-source TypeScript server that uses Mineflayer and the Model Context Protocol to let compatible AI assistants control a Minecraft character through natural-language instructions.

Explore the practical guide ↓

Independent OpenViST project profile, based on linked sources.

Minecraft MCP Server — OpenViST project profile in MCP & Tooling.
OpenViST project illustration. See the linked sources for product details.
Understand the project

Practical overview

When it fits

Use it when an MCP-compatible assistant needs live access to a Minecraft character and the game can be exposed through the documented LAN setup.

Who it is for

  • Developers building Minecraft agents with MCP-compatible clients
  • Minecraft users who want conversational control of a game bot
  • Builders of natural-language tools for movement, exploration and in-game interaction

Documented uses

  • Translate natural-language instructions into Minecraft character actions
  • Build structures by placing and removing blocks
  • Explore and navigate a Minecraft world
  • Inspect and manage inventory and nearby entities
  • Read and send in-game chat
Before you choose

Requirements & limits

The repository is public and licensed under Apache-2.0. The documented setup is self-hosted and requires Git, Node.js 20.10.0 or newer, a running Minecraft game and an MCP-compatible client. The example uses Claude Desktop.

  • Minecraft version support is currently stated as 1.21.11; newer versions may require modification.
  • The implementation uses TypeScript, Node.js and Mineflayer, which matters for developers extending or maintaining the server.
  • The MCP client is a key part of the setup; Claude Desktop is the documented example, while other MCP clients are described as supported without a full compatibility matrix.
  • The exposed command set covers movement, flight, inventory, blocks, furnaces, entities, chat and game-state detection.
  • The server connects to a Minecraft world opened to LAN and uses configurable host and port parameters.

Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.

Source-based practical guide

Connect Claude Desktop to a Minecraft LAN world

Set up the documented MCP connection so Claude Desktop can control a Minecraft character.

Before you start

  • Git
  • Node.js version 20.10.0 or newer
  • A running Minecraft game with a single-player world opened to LAN
  • An MCP-compatible client; the documented example uses Claude Desktop

Steps

  1. Open a single-player Minecraft world to LAN and note the host and port. The documented defaults are localhost and port 25565.

  2. Open Claude Desktop's File, Settings, Developer and Edit Config path, then add the documented minecraft MCP server configuration with the relevant host, port and username values.

  3. Completely close and restart Claude Desktop so it can boot the MCP server.

  4. With Minecraft running and the world still open to LAN, start Claude Desktop and give a chat instruction that explicitly asks the bot to do something in Minecraft.

Expected outcome

The bot should join the Minecraft game and accept natural-language instructions through Claude Desktop; the documentation identifies a startup marker for the MCP server.

Guide limitations

  • The documented current Minecraft support is version 1.21.11; newer versions may not work.
  • The example is based on Claude Desktop, and the complete compatibility range for other models or clients is not specified.
  • The bot may take time to start, and it asks for permissions before running MCP actions.
Documentation 1 ↗
Evidence and transparency

Sources & review

Official repository ↗
Source record details
Source availability
Active
Sources checked
4 October 2026
Original website title
yuniko-software/minecraft-mcp-server · Official homepage title · retained in its source language
How we review sourcesSuggest a correction