# Craftwire MCP server

> Enables AI agents to see and control Minecraft by interacting with Fabric clients and Paper servers through screenshots, commands, and API access.

- Repository: https://github.com/uxplima/craftwire
- Page: https://hostedmcp.org/servers/uxplima/craftwire
- Transport: stdio
- Stars: 4
- License: MIT
- Latest version: 0.10.0

## Install

### Claude Code

```sh
claude mcp add craftwire -- npx -y craftwire
```

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

```json
{
  "mcpServers": {
    "craftwire": {
      "command": "npx",
      "args": [
        "-y",
        "craftwire"
      ]
    }
  }
}
```

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

```json
{
  "servers": {
    "craftwire": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "craftwire"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"craftwire","type":"stdio","command":"npx","args":["-y","craftwire"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

```json
{
  "mcpServers": {
    "craftwire": {
      "command": "npx",
      "args": [
        "-y",
        "craftwire"
      ]
    }
  }
}
```

### Codex

```sh
codex mcp add craftwire -- npx -y craftwire
```

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.craftwire]
command = "npx"
args = ["-y", "craftwire"]
```

### Gemini CLI

```sh
gemini mcp add -s user craftwire npx -- -y craftwire
```

### Gemini settings.json (`~/.gemini/settings.json`)

```json
{
  "mcpServers": {
    "craftwire": {
      "command": "npx",
      "args": [
        "-y",
        "craftwire"
      ]
    }
  }
}
```

## FAQ

### How do I set up Craftwire with my AI client?

You can use the command `npx craftwire setup` followed by your client name (e.g., `codex`, `gemini`, `claude-desktop`) to automatically add the entry to your MCP config.

### Can I use Craftwire if I don't have a Minecraft game currently running?

Yes, the `client_process` tool can start a hidden client that downloads Minecraft and Fabric automatically to join a dev server or open a singleplayer world.

### How do I install the agent on the game side?

Download the appropriate JAR files from the releases page and place the Fabric agent in your `mods/` folder and the Paper agent in your server's `plugins/` folder.

### Can multiple AI clients connect to the same hub?

By default, you should use one client at a time, but you can run `npx craftwire serve` to share a single hub between several clients using MCP over HTTP.
