MMCP

MMCP is a Fabric mod that exposes Minecraft world capabilities to AI assistants through MCP tools and resources.

51 Downloads

fabrictechnologytransportationutility

Rent Server with this Mod

About this Mod

MMCP

MMCP is a Fabric mod that exposes your Minecraft world to AI assistants through the Model Context Protocol (MCP). It runs a local MCP server inside Minecraft, allowing AI tools like Claude, Codex, or any MCP-compatible client to read and interact with your game in real time.

What it does

The mod starts an HTTP-based MCP server at http://127.0.0.1:47355/mcp while Minecraft is running. A lightweight stdio proxy (mmcp.jar) bridges your AI client to this server. Once connected, the AI can call tools to observe the world around your player.

Available tools:

Tool	Description
`get_player_position`	Player coordinates, rotation, dimension, and server address.
`get_player_health_hunger`	Health, absorption, hunger, and saturation values.
`get_inventory`	All non-empty inventory slots including armor and offhand.
`get_nearby_blocks`	Blocks around the player within a configurable radius.
`get_nearby_entities`	Nearby entities sorted by distance, with type and position.
`get_biome`	Current biome at the player's position.
`get_time_weather`	World time, day index, daytime state, rain, and thunder.

All tools are read-only in this release. Control tools are planned for future versions.

Why you'd want this

If you use AI assistants in your workflow, this mod gives them real context about your Minecraft world. Instead of describing your situation in chat, your AI can see your inventory, health, surroundings, and more and help you accordingly.

It also opens the door for autonomous AI gameplay. Future control tools will allow an AI to move, mine, build, and navigate on its own.

Requirements

Minecraft 1.21.1
Fabric Loader 0.18.4+
Java 21
Fabric Language Kotlin 1.13.9+kotlin.2.3.10

Quick Setup

Drop minecraft-mcp-<version>.jar into your mods folder.
Launch Minecraft. The MCP server starts automatically.
Point your MCP client to mmcp.jar:

java -jar mmcp.jar

For Codex CLI:

codex mcp add mmcp -- java -jar path/to/mmcp.jar

Keep Minecraft running while using MCP tools.

Important Notes

The MCP server only listens on 127.0.0.1 (localhost). No data is sent to any remote server.
This mod is intended for singleplayer use or servers you own and control.

Available Versions

MMCP 0.1.0release

MC 1.21.11fabric

February 18, 2026

How to Install MMCP on Your Server

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

Set fabric Loader

In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.11).

Install Mod

Open the mod browser in the dashboard and search for "MMCP". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

fabric

Minecraft Versions

1.21.11

Server-side

✓ Required

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

MMCP server crashes on startup – what to do?

Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.11). You can switch loaders with one click in the panel.

Is MMCP compatible with fabric?

MMCP officially supports fabric for Minecraft 1.21.11. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with MMCP – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if MMCP consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.