MMCP

Quick rating

MMCP

No reviews yet

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

Player Transport
Mod Loaders
Fabric
Minecraft

Community voices

Reviews

Versions
Loading versions…
Match includes

Click once to include, again to exclude, again to clear

Rating Any
Any 0.5 1.0 1.5 2.0 2.5 3.0 3.5 4.0 4.5 5.0
Min
Max
Play Status
Reviews
Time Played
hrs+
Verified developers only
Has developer response
List view
Grid view
Compact view
Sort by
Date
Rating
Helpful
Unhelpful
Edited
Sort ascending
Delete this review?

This removes your review from the project. You can write a new review after.

Review submitted for moderation

Your review has been sent to moderators, who will check that it meets our guidelines before it appears publicly.

No reviews yet. Be the first to review this project!

Get it on

Available Platforms

Compatibility

Supported Environments

Dev Environment
Client Required
Server Required

About

Project Details

Type
Mod
License
LicenseRef Trauma Attribution No Rebranding
Latest Version
0.1.0
Authors

For authors

Embed Badge

If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.

Custom banner text
ModDex rating badge preview

Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.

Identifiers

Platform IDs

Modrinth ID

Resources

External Links

Source Issues Wiki Discord

About

Description

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

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

For Codex CLI:

codex mcp add mmcp -- java -jar path/to/mmcp.jar
  1. 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.

Screenshots

Gallery

This project has no gallery images yet.

Versions

Files

Relations

Project Relations

More like this

Similar Mods

Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.

On ModDex

Community snapshot

0
Ratings
0
Followers
0
In stacks

By the numbers

Statistics

<1,000
Downloads
Last Updated
CurseForge
Created
Last synced
When ModDex last fetched this project from CurseForge or Modrinth. Every project is re-checked on a schedule, and any project that ships a new file is synced automatically within hours of the release.
New file updates sync automatically
How syncing works