MCP Fabric (Minecraft) — Claude Code MCP server: setup
MCP Fabric (Minecraft) is an MCP server for Claude Code that connects an AI client to Minecraft: Java Edition through the mcpfabric mod, letting an agent inspect and control the game world.
MIT ★ 21 updated 2026-11-13
claude mcp add --env MCPFABRIC_TOKEN=<MCPFABRIC_TOKEN> --env MCPFABRIC_TOOLSETS=<MCPFABRIC_TOOLSETS> --transport stdio mcp-server -- npx -y mcpfabric-mcp-serverWhat MCP Fabric (Minecraft) does
The server relays client requests to the HTTP bridge exposed by the mcpfabric mod for Fabric or NeoForge. Its tool set covers roughly 50 ways to inspect the world and interact with the game. An agent runtime also keeps memory and goals, maps the world, and handles background jobs.
Script mode runs JavaScript in QuickJS, while saved programs and skills are kept per world. It requires Node.js 22.16 or later, a running Minecraft instance with the mod, and the token from the mod configuration. The game bridge will not accept a connection without that token.
What it helps with
- inspect the game world through an AI client
- control Minecraft from an MCP client
- keep agent memory separate for each world
- run scripts that interact with the game
Example prompts for the agent
- Inspect the current Minecraft world and describe what is happening.
- Control my character in Minecraft to complete this task: …
- Save a skill for this world so it can be run again later.
How to install MCP Fabric (Minecraft)
Platform CLI
claude mcp add --env MCPFABRIC_TOKEN=<MCPFABRIC_TOKEN> --env MCPFABRIC_TOOLSETS=<MCPFABRIC_TOOLSETS> --transport stdio mcp-server -- npx -y mcpfabric-mcp-serverReplace <…> with your own values
Platform CLI
codex mcp add mcp-server --env MCPFABRIC_TOKEN=<MCPFABRIC_TOKEN> --env MCPFABRIC_TOOLSETS=<MCPFABRIC_TOOLSETS> -- npx -y mcpfabric-mcp-serverReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp-server": {
"command": "npx",
"args": [
"-y",
"mcpfabric-mcp-server"
],
"env": {
"MCPFABRIC_TOKEN": "<MCPFABRIC_TOKEN>",
"MCPFABRIC_TOOLSETS": "<MCPFABRIC_TOOLSETS>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcpfabric-mcp-server"
],
"env": {
"MCPFABRIC_TOKEN": "<MCPFABRIC_TOKEN>",
"MCPFABRIC_TOOLSETS": "<MCPFABRIC_TOOLSETS>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e MCPFABRIC_TOKEN=<MCPFABRIC_TOKEN> -e MCPFABRIC_TOOLSETS=<MCPFABRIC_TOOLSETS> mcp-server npx -y mcpfabric-mcp-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about MCP Fabric (Minecraft)
How do I install MCP Fabric (Minecraft) in Claude Code?
Run claude mcp add mcpfabric -e MCPFABRIC_TOKEN=<MCPFABRIC_TOKEN> -- npx -y mcpfabric-mcp-server. Replace <MCPFABRIC_TOKEN> with the token from the mod configuration.
What does MCP Fabric (Minecraft) do?
It connects an MCP client to the game bridge provided by the mcpfabric mod, with tools for inspecting and controlling Minecraft. Its agent runtime also stores memory and goals and runs background jobs.
What does MCP Fabric (Minecraft) need to run?
It requires Node.js 22.16 or later, Minecraft: Java Edition running the mcpfabric mod for Fabric or NeoForge, and the token from the mod configuration.