# MCP Fabric (Minecraft)

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 21 repo stars
- Author: denfry
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/denfry/mcpfabric/tree/HEAD/mcp-server
- Updated: 2026-11-13
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-fabric-minecraft

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `MCPFABRIC_TOKEN`, `MCPFABRIC_TOOLSETS` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env MCPFABRIC_TOKEN=<MCPFABRIC_TOKEN> --env MCPFABRIC_TOOLSETS=<MCPFABRIC_TOOLSETS> --transport stdio mcp-server -- npx -y mcpfabric-mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp-server --env MCPFABRIC_TOKEN=<MCPFABRIC_TOKEN> --env MCPFABRIC_TOOLSETS=<MCPFABRIC_TOOLSETS> -- npx -y mcpfabric-mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "mcpfabric-mcp-server"
            ],
            "env": {
                "MCPFABRIC_TOKEN": "<MCPFABRIC_TOKEN>",
                "MCPFABRIC_TOOLSETS": "<MCPFABRIC_TOOLSETS>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e MCPFABRIC_TOKEN=<MCPFABRIC_TOKEN> -e MCPFABRIC_TOOLSETS=<MCPFABRIC_TOOLSETS> mcp-server npx -y mcpfabric-mcp-server
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [minecraft-modding](https://affpapa.org/en/nevibecode/skills/minecraft-modding.md) — skill · 966 installs
- [minecraft-testing](https://affpapa.org/en/nevibecode/skills/minecraft-testing.md) — skill · 386 installs
- [minecraft-bukkit-pro](https://affpapa.org/en/nevibecode/skills/minecraft-bukkit-pro.md) — skill · 131 installs
- [minecraft-mcp](https://affpapa.org/en/nevibecode/mcp/minecraft-mcp.md) — MCP server · ★ 26 repo stars
- [mc-asset — Minecraft Pixel Asset Engine](https://affpapa.org/en/nevibecode/mcp/mc-asset-minecraft-pixel-asset-engine.md) — MCP server · ★ 5 repo stars
- [Minecraft Wiki](https://affpapa.org/en/nevibecode/mcp/minecraft-wiki.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
