Home

mcpfabric

Let Claude and other MCP clients see, understand and play Minecraft. mcpfabric is a Fabric and NeoForge mod that embeds a local HTTP bridge in the game, plus a TypeScript Model Context Protocol server that turns the bridge into 50+ tools. It runs on the client (the AI plays as you) and on dedicated servers (the AI administers), on Minecraft 1.21.1 to 1.21.11 and 26.1 to 26.3.

Download on Modrinth · Source · Issues · Security policy

Start here

I want to...	Read
install the mod and get the token	Installation
connect Claude Desktop, Claude Code or another MCP client	Connecting an MCP client
see what the AI can do	Tools
give the AI memory, goals and background jobs	Agent runtime
limit what the AI is allowed to do	Capability locks and security
fix an error	Troubleshooting
build the mod or send a pull request	Development

How it fits together

Claude / any MCP client
        |  MCP (stdio or streamable HTTP)
   mcp-server (Node)
        |  HTTP POST /rpc + GET /events (SSE), bearer token, 127.0.0.1 only
   mod "mcpfabric" (Fabric or NeoForge)
        |  all game access runs on the game thread
   Minecraft

Warning: mcpfabric can give an AI operator-level control of your game. Keep the bridge on 127.0.0.1, keep authentication on, and switch off the capability groups you do not need. See Capability locks and security.

The README in the repository stays the reference for versions and configuration; this wiki is the guided tour.