Awesome Mineflayer MCP

A production-ready Model Context Protocol server that gives an LLM agent standalone-equivalent control over a Mineflayer Minecraft bot - movement, mining, crafting, inventory, combat, containers, chat, and much more - exposed as 123 strongly-typed tools across 26 groups, plus guided prompts, vision (real first-person screenshots + schematic maps), persistent waypoints, build/dig macros, and dual (poll + push) event…

People connecting gaming tools to Claude, Cursor, VS Code, or another MCP client. The project is written in TypeScript.

VERIFIED ACTIVE

LAST COMMIT 2026-06-29 · ★ 2 · #27 OF 35 MAINTAINED GAMING · VERIFIED 2026-08-25

MIT · TypeScript servers · how we verify → /methodology

01 · Install Awesome Mineflayer MCP

before you install - you'll need

Set MCP_DISABLE_GROUPS, ONLINE_MODE before connecting. MCP_DEFAULT_HOST, MCP_DEFAULT_USERNAME, MCP_DEFAULT_AUTH, MCP_AUTO_CONNECT are optional or environment-specific per the README.

Claude Code

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

Claude Desktop / Cursor / VS Code - add to config

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

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

repo age created 2026-06-28 - young repo, little track record yet

license MIT - declared in the repository

npm package awesome-mineflayer-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.G0Osey99 is GitHub-verified and matches the repo owner

03 · What Awesome Mineflayer MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Limitations (from the README)

- One bot per server process (single-session by design). - Evaluations require a seeded world. A live Minecraft world is not deterministic, so the evaluation set in eval/ targets a documented seeded fixture (see eval/fixture.md); it cannot be verified against an arbitrary live server. - cancel_fish is best-effort (Mineflayer exposes no first-class fishing abort). - Microsoft auth's first run needs an interactive devi

04 · Who maintains Awesome Mineflayer MCP

Awesome Mineflayer MCP is maintained by g0osey99. It's the only MCP server we track from this author; the repo dates to Jun 2026.

05 · Facts

repository: github.com/g0osey99/awesome-mineflayer-mcp
website: https://github.com/G0Osey99/awesome-mineflayer-mcp#readme
category: gaming - ranked #27 of 35 actively-maintained gaming servers as of 2026-08-25.
registry: io.github.G0Osey99/awesome-mineflayer-mcp (active, first published 2026-06-29)
packages: npm:awesome-mineflayer-mcp

06 · Awesome Mineflayer MCP FAQ

What is Awesome Mineflayer MCP?

Is Awesome Mineflayer MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-06-29. We re-verify nightly.

How do I install Awesome Mineflayer MCP?

Run `npx -y awesome-mineflayer-mcp`. The README documents 6 environment variables (MCP_DISABLE_GROUPS, MCP_DEFAULT_HOST, MCP_DEFAULT_USERNAME…) to set first. Set MCP_DISABLE_GROUPS, ONLINE_MODE before connecting. MCP_DEFAULT_HOST, MCP_DEFAULT_USERNAME, MCP_DEFAULT_AUTH, MCP_AUTO_CONNECT are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does Awesome Mineflayer MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Awesome Mineflayer MCP

Alternatives to Awesome Mineflayer MCP

Maintained gaming servers if Awesome Mineflayer MCP isn't the fit.

More gaming MCP servers · Glade MCP · Onepiece Oracle · Warhammer Oracle · Steam MCP Server

More TypeScript MCP servers · Gamedev Pl · Microcharts · useVyre Context · Gatefareio MCP Server · Ani MCP · see all