Skip to content
MCP server

Awesome Mineflayer MCP

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

Runs locallyStatus and history
Install
Pricing
Open source
Runs
Locally
Version
1.3.2
Listing updated
5 days ago

About Awesome Mineflayer MCP

Awesome Mineflayer MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.

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

Install

Run in a terminal

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

Add to claude_desktop_config.json

{
  "mcpServers": {
    "awesome-mineflayer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "awesome-mineflayer-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "awesome-mineflayer-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "awesome-mineflayer-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

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

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

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

Add to your client's MCP settings (most use this shape)

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

Using several servers? Build one config file with the MCP config generator.

Configuration

  • MCP_DEFAULT_HOSTServer to auto-connect on startup (optional).
  • MCP_DEFAULT_USERNAMEIn-game name (offline) or account email (microsoft).
  • MCP_DEFAULT_AUTHAuth mode: offline or microsoft.
  • MCP_DISABLE_GROUPSComma-separated tool-group keys to disable.
  • MCP_READ_ONLYObserve-only mode (no world-mutating tools).
  • MCP_ALLOWED_HOSTSComma-separated allow-list of hosts the bot may join.

Pricing

Open source

Awesome Mineflayer MCP FAQ

Is Awesome Mineflayer MCP free?

Yes. Awesome Mineflayer MCP is open source, so you can use and self-host it for free.

How do I add Awesome Mineflayer MCP to Claude Code?

Run this command in your terminal: claude mcp add awesome-mineflayer-mcp -- npx -y awesome-mineflayer-mcp

Where this comes from

  • Description: from the official MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers