Awesome Mineflayer MCP Server

by g0osey99io.github.G0Osey99/awesome-mineflayer-mcpv1.3.2

Control a Mineflayer Minecraft bot with 120+ MCP tools: move, mine, craft, fight, build, and see.

4Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing3mo ago

Install Awesome Mineflayer MCP server

claude mcp add awesome-mineflayer -- npx -y awesome-mineflayer-mcp

{
  "mcpServers": {
    "awesome-mineflayer": {
      "command": "npx",
      "args": [
        "-y",
        "awesome-mineflayer-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "awesome-mineflayer": {
      "command": "npx",
      "args": [
        "-y",
        "awesome-mineflayer-mcp"
      ]
    }
  }
}

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

{
  "servers": {
    "awesome-mineflayer": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "awesome-mineflayer-mcp"
      ]
    }
  }
}

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

{
  "mcpServers": {
    "awesome-mineflayer": {
      "command": "npx",
      "args": [
        "-y",
        "awesome-mineflayer-mcp"
      ]
    }
  }
}

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

Configuration

Variable	Required	Secret	Description
MCP_DEFAULT_HOST	—	—	Server to auto-connect on startup (optional).
MCP_DEFAULT_USERNAME	—	—	In-game name (offline) or account email (microsoft).
MCP_DEFAULT_AUTH	—	—	Auth mode: offline or microsoft.
MCP_DISABLE_GROUPS	—	—	Comma-separated tool-group keys to disable.
MCP_READ_ONLY	—	—	Observe-only mode (no world-mutating tools).
MCP_ALLOWED_HOSTS	—	—	Comma-separated allow-list of hosts the bot may join.

Freshness

Slowing — last maintenance signal 3mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-06-29 · 3mo ago · GitHub
Latest release
no data · GitHub
Package published
no data · npm/PyPI
Registry entry updated
2026-06-29 · 3mo ago · official registry · v1.3.2

FAQ

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

Run: claude mcp add awesome-mineflayer -- npx -y awesome-mineflayer-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Awesome Mineflayer require an API key?

No required environment variables are declared in its published metadata.

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

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

›Is Awesome Mineflayer in the official MCP registry?

Yes, as io.github.G0Osey99/awesome-mineflayer-mcp.