Control a local Minecraft client. Requires the Minecraft MCP mod and JsMacros Reloaded.
MCPpedia last refreshed this data
io.github.MakkCH/minecraft-mcp is an MCP server that control a local Minecraft client. Requires the Minecraft MCP mod and JsMacros Reloaded. Its tool list has not been published yet over stdio, sse and http, requires no API key, and scores 64/100 on MCPpedia's security, maintenance and efficiency rubric.
Config is the same across clients - only the file and path differ.
{
"mcpServers": {
"minecraft_mcp": {
"env": {
"MINECRAFT_MCP_PORT": "28473",
"MINECRAFT_MCP_TOKEN": "YOUR_TOKEN"
},
"args": [
"-y",
"@makkch/minecraft-mcp@latest"
],
"command": "npx"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
Control a local Minecraft client. Requires the Minecraft MCP mod and JsMacros Reloaded.
Run this in your terminal to verify the server starts. Then let us know if it worked - your result helps other developers.
npx -y '@makkch/minecraft-mcp' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories - click any category to see the underlying evidence.
No known CVEs.
Checked @makkch/minecraft-mcp against OSV.dev.
Be the first to review
Have you used this server?
Share your experience - it helps other developers decide.
Sign in to write a review.
Others in entertainment
The official MCP Server for the Mux API
Give Claude the ability to watch and understand videos — Claude Code plugin with frame extraction and multimodal audio analysis
Make games with AI: one MCP server that connects your agent to Unity, Unreal and Godot editors.
MCP server for *arr media suite - Sonarr, Radarr, Lidarr, Readarr, Prowlarr
MCP Security Weekly
Get CVE alerts and security updates for io.github.MakkCH/minecraft-mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
Let an AI agent play in your Minecraft client. Take over with /mcp stop.
English · 繁體中文
Gallery · Requirements · Installation · Staying in control · Remote connection
The agent controls your character with JsMacros scripts: it writes one, runs it, reads the output, takes a screenshot, and reports in chat. You watch from your own point of view and type /mcp stop whenever you want the controls back.
Everything here was done by an agent through Minecraft MCP. Browse all projects.
From an empty inventory to the End PoemA Codex agent ( Java 26.3, Normal difficulty, about 8 hours 25 minutes. Full run and retrospective |
F36: a compact 6× shulker box loaderA 3×3×4 single-item shulker box loader designed by GPT-6 Astra. Modules with minecarts tile every three blocks at the same height; a single module runs without one. Schematics exported from Java 26.3. Watch the video · Download the schematics |
The banner scene was built and captured in Minecraft by GPT-6 Astra using Minecraft MCP.
Fabric only for now. Forge, NeoForge and other Minecraft versions are not supported yet.
| Minecraft Java Edition | Download this JAR group | Baritone API Fabric (optional) |
|---|---|---|
| 26.1, 26.1.1, 26.1.2 | 26.1 | 1.18.0 |
| 26.2 | 26.2 | 1.19.0 |
| 26.3 | 26.3 | 1.20.0 |
| Component | Requirement |
|---|---|
| Fabric Loader | 0.19.5 or later |
| Java | 25 or later |
| JsMacros Reloaded | 2.2.1, same JAR group as above (bundles the Fabric API modules this mod needs) |
| Node.js | 22+ for the MCP server; 22.20+ for Skills CLI |
| Agent | Codex, Claude Code, Claude Desktop, Cursor, or any client with stdio MCP support |
| Baritone | Optional, strongly recommended |
Without Baritone, scripts, screenshots and direct player control still work, but t