Skip to content
MCP server

MCP Fabric (Minecraft)

Let an AI agent see, build in and operate Minecraft Java Edition through a Fabric mod

Runs locallyStatus and history
Install
Pricing
Free
Platforms
CLI, self-hosted
Runs
Locally
Version
0.10.0
Listing updated
3 days ago

About MCP Fabric (Minecraft)

MCP Fabric (Minecraft) is a free MCP server for games and play. It runs locally on your machine and is started by your AI client.

Two pieces work together here: a Fabric or NeoForge mod that runs a small HTTP bridge inside Minecraft, and a Node MCP server that exposes the game to your assistant. The bridge binds to 127.0.0.1 and requires a bearer token read from the mod's config file, so it stays local by default.

On the client side the agent can move, mine, place blocks, fight, manage the hotbar and inventory, pathfind with a built-in A* navigator and take screenshots for vision models. On a server it can run operator commands, fill regions, summon entities, change time and weather, and manage players. About 50 tools are published, and MCPFABRIC_TOOLSETS can limit them to profiles such as play, admin or build.

The server also ships an agent runtime with persistent memory, goals, a world map and background jobs stored in SQLite, plus a code mode that runs model-written JavaScript in QuickJS. One source tree builds 14 jars covering Minecraft 1.21.1 to 26.3.

Install

Run in a terminal

claude mcp add mcpfabric --env MCPFABRIC_TOKEN='<MCPFABRIC_TOKEN>' -- npx -y mcpfabric-mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcpfabric": {
      "command": "npx",
      "args": [
        "-y",
        "mcpfabric-mcp-server"
      ],
      "env": {
        "MCPFABRIC_TOKEN": "<MCPFABRIC_TOKEN>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcpfabric": {
      "command": "npx",
      "args": [
        "-y",
        "mcpfabric-mcp-server"
      ],
      "env": {
        "MCPFABRIC_TOKEN": "<MCPFABRIC_TOKEN>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcpfabric": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mcpfabric-mcp-server"
      ],
      "env": {
        "MCPFABRIC_TOKEN": "<MCPFABRIC_TOKEN>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcpfabric": {
      "command": "npx",
      "args": [
        "-y",
        "mcpfabric-mcp-server"
      ],
      "env": {
        "MCPFABRIC_TOKEN": "<MCPFABRIC_TOKEN>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcpfabric": {
      "command": "npx",
      "args": [
        "-y",
        "mcpfabric-mcp-server"
      ],
      "env": {
        "MCPFABRIC_TOKEN": "<MCPFABRIC_TOKEN>"
      }
    }
  }
}

Configuration

  • MCPFABRIC_TOKENBridge token; not needed while the game writes ~/.mcpfabric/bridge.json.
  • MCPFABRIC_TOOLSETSServe only some tools: profiles play, admin, build or tool groups.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

screenshot
Capture a game screenshot as an image
run_script
Run a model-written JavaScript program against the game
save_skill
Save a script as a per-world skill
run_skill
Run a saved skill

What it does

Play as the player
Movement, mining, building, combat, inventory and A* pathfinding.
Vision
Screenshots are returned as image content for vision models.
Operator powers
Run commands, edit blocks, summon entities and manage players.
Event polling
Reads damage, deaths, chat, spawns and joins.
Persistent agent memory
Goals, a world map and jobs are kept in a local SQLite database.
Scripted skills
Run model-written scripts in a sandbox and save them per world.
Toolset profiles
Expose only play, admin or build tools.

Good for

  • Have Claude build a structure from a description
  • Let an agent act as a server administrator
  • Run an AI player that explores and gathers resources
  • Test an agent's planning in a sandbox world

Pricing

Free

Free mod download on Modrinth and npm package

Prices change. Check modrinth.com before you buy.

MCP Fabric (Minecraft) FAQ

Which Minecraft versions work?

Java Edition 1.21.1 to 26.3, with one jar per version.

What does it need?

Fabric Loader 0.19.5 or newer, Fabric API and Node.js; the README states 22.16 or later for the server package.

Is it safe to expose?

The bridge listens on 127.0.0.1 only and requires a bearer token.

Does it work on servers?

Yes, install the jar on a dedicated Fabric server for admin-style tools.

Is MCP Fabric (Minecraft) free?

Yes. MCP Fabric (Minecraft) is free to use.

How do I add MCP Fabric (Minecraft) to Claude Code?

Run this command in your terminal: claude mcp add mcpfabric --env MCPFABRIC_TOKEN='<MCPFABRIC_TOKEN>' -- npx -y mcpfabric-mcp-server

What are the best alternatives to MCP Fabric (Minecraft)?

The closest alternatives to MCP Fabric (Minecraft) are AvatarSay — Fictional Character & Talking Video MCP, VfxSmith, Born Then, Haze City and Vector Alienspace.

Alternatives to MCP Fabric (Minecraft)

  1. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  2. Born Then

    MCP server

    Free MCP server that rolls random historical births weighted by real demographics

    • 2 tools
    • Remote
    • Free
    • Education and exams
  3. Haze City

    MCP server

    MCP server for agents to look around and build in a shared 3D world

    • 17 tools
    • Remote
    • Open source
    • Games and play
  4. A Galaga-style space shooter played from below, open to humans and AI agents

    • 6 tools
    • Remote
    • Free
    • Knowledge and memory
  5. Vector Abyss

    MCP server

    Play a Tempest-style 3D tube shooter, or let an AI agent play it turn by turn

    • 6 tools
    • Remote
    • Free
    • Knowledge and memory