# MCP Fabric (Minecraft)

> MCP Fabric (Minecraft) is a free MCP server for games and play. Let an AI agent see, build in and operate Minecraft Java Edition through a Fabric mod. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, self-hosted
- **Website:** https://modrinth.com/mod/mcpfabric
- **Repository:** https://github.com/denfry/mcpfabric/tree/HEAD/mcp-server
- **MCP Registry name:** io.github.denfry/mcpfabric
- **Categories:** games and play
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.
- [Born Then](https://ai-powered.com/mcp/born-then): Born Then is a free MCP server for education and exams.
- [Haze City](https://ai-powered.com/mcp/haze-city): Haze City is an open-source MCP server for games and play.
- [Vector Alienspace](https://ai-powered.com/mcp/vector-alienspace): Vector Alienspace is a free MCP server for knowledge and memory.
- [Vector Abyss](https://ai-powered.com/mcp/vector-abyss): Vector Abyss is a free MCP server for knowledge and memory.
- [Vector Defence](https://ai-powered.com/mcp/vector-defence): Vector Defence is a free MCP server for knowledge and memory.
- [Vectoroids](https://ai-powered.com/mcp/vectoroids): Vectoroids is a free MCP server for games and play.

---
Source: https://ai-powered.com/mcp/mcp-fabric-minecraft
