Minecraft Remote

What is Minecraft Remote?

Minecraft Remote is an MCP (Model Context Protocol) server that enables an AI assistant to control a Minecraft player on a remote Java Edition server. It is built from scratch to support remote connections, unlike the original project it was inspired by.

How to use Minecraft Remote?

Install via npm (npm install -g mcp-minecraft-remote) or Smithery (npx -y @smithery/cli install @nacal/mcp-minecraft-remote), then add the server configuration to your Claude Desktop config file. After restarting Claude, use tools like connectToServer to connect to a Minecraft server (must have online-mode=false set). See the README for full configuration examples.

Key features of Minecraft Remote

• Connect to and control a Minecraft player remotely
• Navigate, mine, build, and interact with the world
• Chat with other players on the server
• Check inventory, position, and server information
• Advanced movement: jumping, sneaking, and sprinting
• Craft items and trade with villagers

Use cases of Minecraft Remote

• Automate building or mining tasks via AI commands
• Monitor server status and player position remotely
• Interact with containers (chests, furnaces) programmatically
• Follow or attack entities under AI guidance
• Craft items and trade with villagers without manual gameplay

FAQ from Minecraft Remote

What is the difference between Minecraft Remote and the original mcp-minecraft?

The original project only supports local Minecraft server connections, while Minecraft Remote was created from scratch to add support for connecting to remote servers.

What are the runtime requirements?

Node.js 18+, an AI assistant that supports MCP (like Claude), and a Minecraft Java Edition server (version 1.8 or later). It has been tested with vanilla Minecraft 1.21.

Does the server need a specific configuration?

Yes, the Minecraft server must have online-mode=false set in server.properties to allow the bot to connect without authentication. If authentication is required, valid premium account credentials must be provided.

What data is exchanged with the server?

The bot connects to the Minecraft server using the credentials you provide. All player actions (movement, inventory, chat, etc.) are sent to the server. No data is stored locally beyond the standard MCP configuration.

Is modded or non‑vanilla Minecraft supported?

Compatibility is not guaranteed with modded servers or versions other than 1.21. The tool has been verified specifically with vanilla Minecraft 1.21.