Minecraft MCP Server

Minecraft game control via MCP to allow AI agents to act as in-game bots.

Data last scanned yesterday · Reviewed 3 weeks ago

12 1 dangerous tool18 tools★ 695TypeScriptApache-2.0

Overview

The Minecraft MCP Server acts as an bridge, leveraging the Mineflayer API to translate AI commands into actions within a local Minecraft Java Edition game. By utilizing the Model Context Protocol, it allows LLMs to control a character's presence and interactions within a singleplayer world opened to LAN.

Our verdict

With a security score of 42/100, this server is classified as high-risk. The primary concern is the lack of a read-only mode, as the server provides full write access to the Minecraft instance upon connection. Given the community-maintained nature and the absence of an editorial security review, this tool is best suited for experimental environments rather than sensitive or production setups.

Uses Mineflayer API for robust Minecraft interactions.
Small footprint with only seven direct dependencies.
Open source project under the Apache-2.0 license.

No read-only mode ensures full write access to game.
No OAuth support for secure authentication.
Last commit occurred over four months ago.

Setup

Claude Desktop

{
  "mcpServers": {
    "minecraft-mcp-server": {
      "args": [
        "-y",
        "minecraft-mcp-server"
      ],
      "command": "npx"
    }
  }
}

Paste into ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop. Some servers require API keys or tokens as environment variables — check the project's README and add an "env" object if needed.

No read-only mode — running this grants full read/write access.
No built-in authentication — anyone with access to this config can invoke every tool it exposes.

Tools

Tool	Description	Risk
get-position	Get the current position of the bot	low
move-to-position	Move to specific coordinates	medium
look-at	Make the bot look at specific coordinates	medium
jump	Make the bot jump	medium
move-in-direction	Move in a specific direction for a duration	medium
fly-to	Make the bot fly directly to specific coordinates	medium
list-inventory	List all items in the bot's inventory	low
find-item	Find a specific item in inventory	low
equip-item	Equip a specific item	medium
place-block	Place a block at specified coordinates	medium

Compatibility

Client	Local	Docker	Remote	Read-only
ChatGPT
Claude Desktop
Cursor
VS Code
Windsurf

Frequently asked questions

›Which Minecraft version is supported?

The server currently supports Minecraft version 1.21.11. Support for newer versions will be added in the future.

›What are the system prerequisites for running this server?

You must have Git, Node.js (version 20.10.0 or higher), a running Minecraft Java Edition instance, and an MCP-compatible client installed.

›How do I make my Minecraft world accessible to the bot?

You must create a singleplayer world and open it to LAN using the 'Open to LAN' button in the game's ESC menu.

›Can I customize the connection settings?

Yes, you can configure the hostname and port parameters in the claude_desktop_config.json file, though the defaults are set to localhost and port 25565.

›How do I trigger the bot to perform an action?

You must explicitly mention that the bot should perform a task within your prompt in Claude Desktop. The MCP server will then request your permission to execute the required commands.