Minecraft MCP Server

by mairwunnxcom.mairwunnx/minecraft-mcpv2.2.0

Ask an AI about your Minecraft server and let it run it: players, worlds, stats, and live events.

0Node.jsstdioofficial registry

context tax

pending

security

pending

cold start

pending

freshness

pending

Our reading of Minecraft, from the data

Minecraft is a gaming MCP server from mairwunnx, listed in the official MCP Registry.

We haven't measured its tool list yet, so its token cost is unknown.

With 0 GitHub stars it ranks #185 of 428 gaming servers we index.

It runs locally on your machine over stdio and needs one secret (WORLDAPI_TOKEN); use a scoped, least-privilege key.

Install Minecraft MCP server

claude mcp add minecraft -e WORLDAPI_URL='<worldapi-url>' -e WORLDAPI_TOKEN='<worldapi-token>' -- npx -y @mairwunnx/minecraft-mcp

{
  "mcpServers": {
    "minecraft": {
      "command": "npx",
      "args": [
        "-y",
        "@mairwunnx/minecraft-mcp"
      ],
      "env": {
        "WORLDAPI_URL": "<worldapi-url>",
        "WORLDAPI_TOKEN": "<worldapi-token>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "minecraft": {
      "command": "npx",
      "args": [
        "-y",
        "@mairwunnx/minecraft-mcp"
      ],
      "env": {
        "WORLDAPI_URL": "<worldapi-url>",
        "WORLDAPI_TOKEN": "<worldapi-token>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "minecraft": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@mairwunnx/minecraft-mcp"
      ],
      "env": {
        "WORLDAPI_URL": "<worldapi-url>",
        "WORLDAPI_TOKEN": "<worldapi-token>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "minecraft": {
      "command": "npx",
      "args": [
        "-y",
        "@mairwunnx/minecraft-mcp"
      ],
      "env": {
        "WORLDAPI_URL": "<worldapi-url>",
        "WORLDAPI_TOKEN": "<worldapi-token>"
      }
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
WORLDAPI_URL	yes	—	WorldAPI base URL including /api/v1, such as http://localhost:8110/api/v1
WORLDAPI_TOKEN	—	yes	A WorldAPI token; its scopes decide which tools the agent gets. Leave empty for what anonymous clients may read.
WORLDAPI_READ_ONLY	—	—	1 hides every tool that changes the server

Freshness

Not enough public signals yet to judge maintenance.

Last commit (default branch)
2026-10-16 · 3d ago · GitHub
Latest release
2026-10-16 · 3d ago · GitHub · v2.2.0
Package published
no data · npm/PyPI
Registry entry updated
2026-10-16 · 3d ago · official registry · v2.2.0

How it compares in Gaming

Against the most-starred gaming servers we index. Token cost is per model turn, measured from each server's live tool list.

Server	Stars	Tools	Tokens / turn	Freshness	Runs
Minecraft (this)	0	—	not measured	—	local
Godot	6,152	—	not measured	Slowing	local
Unity	4,494	—	not measured	Active	local
Unity	1,936	—	not measured	Maintained	—
Gearboy	1,219	—	not measured	Active	local
Unreal Engine	958	—	not measured	Active	local + hosted

All gaming MCP servers

FAQ

›How do I install the Minecraft MCP server in Claude Code?

Run: claude mcp add minecraft -e WORLDAPI_URL='<worldapi-url>' -e WORLDAPI_TOKEN='<worldapi-token>' -- npx -y @mairwunnx/minecraft-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Minecraft require an API key?

Yes. It expects WORLDAPI_URL, WORLDAPI_TOKEN, of which 1 is a secret.

›Can I use Minecraft as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Minecraft in the official MCP registry?

Yes, as com.mairwunnx/minecraft-mcp.

Sources and method

Official MCP Registry entry: updated 2026-10-16
GitHub repository: fetched 2026-10-19
Package registry (npm / PyPI): listed
Last checked against all sources: 2026-10-19

The description, packages and links come from the maintainer's own published metadata. Token cost, security signals, freshness and the reading above are MCPSkillHub's own measurements; see the methodology. Spot an error? Request a correction or claim the listing.