Installation

One-time setup on your machine. After this, your AI client handles the rest.

Requirements #

Node.js 18 or newer
Network access to github.com and minehut.com
A Minehut account with at least one server

Install #

# Install the server globally
npm install -g github:Tobralla/minehut-mcp

# Install Chromium for the browser layer
minehut-mcp-setup

The package is plain Node.js with Playwright. There are no native modules, so the same two commands work on macOS, Windows and Linux. Other package managers such as pnpm and yarn work just as well for the global install.

Environment variables #

Variable	Purpose
`MINEHUT_EMAIL`	Account email used by `browser_login_panel` when the arguments are omitted
`MINEHUT_PASSWORD`	Account password for the same fallback
`MINEHUT_TOKEN`	Skip the browser login and authenticate the API layer directly
`MINEHUT_SESSION_ID`	Session id paired with `MINEHUT_TOKEN`
`MINEHUT_HEADLESS=0`	Launch the browser with a visible window. Recommended for the first login, since Cloudflare challenges are easier to solve by hand

Running from source #

git clone https://github.com/Tobralla/minehut-mcp.git
cd minehut-mcp
npm install
npm run dev

Build the production bundle with npm run build and start it with npm start. The dev script uses tsx and restarts on every change, which is convenient while contributing.

Verify the install #

Add the server to your AI client (see client setup) and ask it to call minehut_help. The tool returns a short guide plus the current browser mode. A missing Chromium install surfaces as a clear message from any browser_* tool, telling you exactly what to run.

Previous← Overview NextClient setup →