MMCP
No reviews yet
MMCP is a Fabric mod that exposes Minecraft world capabilities to AI assistants through MCP tools and resources.
Adds new methods of transportation for players.
Fabric is a mod loader for versions 1.14+ of Minecraft, particularly popular for client side and optimization mods.
Community voices
Reviews
Click once to include, again to exclude, again to clear
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
Compatibility
Supported Environments
About
Project Details
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.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
Resources
External Links
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
- Drop
minecraft-mcp-<version>.jarinto yourmodsfolder. - 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.
Screenshots
Gallery
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
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers
Statistics
Resources