Skip to content

Releases: MakkCH/minecraft_mcp

Release list

Minecraft MCP v0.2.1

Minecraft MCP v0.2.1 Latest
Latest

Choose a tag to compare

View all tags
@MakkCH MakkCH released this 01 Nov 14:25
v0.2.1
bf073bf

First public release of Minecraft MCP: let an AI agent play in your own Minecraft client while you watch and stay in control.

Downloads

Download both packages below. The client mod and agent package are versioned independently and are compatible through protocol version 1.

Asset Purpose
minecraft-mcp-0.2.0.jar Fabric client mod; put it in your instance's mods/ folder.
minecraft-mcp-0.2.1.tgz MCP server, bundled Node.js dependencies, Skill, API references, examples and Codex plugin metadata.
SHA256SUMS SHA-256 checksums for both packages.

The automatically generated source archives are for development. Use the JAR and TGZ above for installation.

Requirements

  • Minecraft Java Edition 26.3, Fabric Loader 0.19.5 or later, and Java 25 or later.
  • JsMacros Reloaded 2.2.1 in the Minecraft instance.
  • Node.js 22 or later for the agent package.
  • A local MCP client, such as Codex, Claude Code, Claude Desktop or Cursor.
  • Baritone is strongly recommended for navigation, mining and building, but is optional.
  • Mod Menu is optional; version 21.0.0 was used to verify the settings integration.

Minecraft and the MCP server run on the same computer. Other Minecraft versions and loaders have not been verified.

Included

  • Five MCP tools: execute, read_output, stop, screenshot and chat.
  • JsMacros JavaScript execution with incremental output, game screenshots and access to installed mod APIs.
  • Player takeover through /mcp stop, plus /mcp start and /mcp status.
  • Native settings through Mod Menu → Minecraft MCP → Configure, F8 or /mcp config.
  • Editable connection token, automatic startup and configurable local [AGENT] messages.
  • Companion Skill with API lookup, reusable scripts and examples.
  • Gson-based JSON responses, PNG icons and MIT licensing.

Each execution starts a fresh JsMacros context; top-level variables are not shared between calls. Running scripts can continue producing output.

Installation

  1. Add the client JAR and JsMacros to a compatible Fabric instance.
  2. Open Minecraft MCP settings and copy the port and token.
  3. Extract the agent package and follow the setup guide for your MCP client.

The mod and agent keep their settings separately, outside the installed packages. No launcher instance, world save or pairing credentials are included.

Validation

The release JAR was assembled successfully, and the extracted agent package passed the official MCP SDK protocol check. Real Minecraft client integration checks covered script output, screenshots, main-thread callbacks, token rotation, Mod Menu registration and return navigation.

MIT License · Copyright © 2026 Mak

Assets 5
Loading