World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Control a Mineflayer Minecraft bot with 120+ MCP tools: move, mine, craft, fight, build, and see.
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 12/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 3/12 | Puntuación completa con una versión o cambio de código en 30 días |
| Sigue respondiendo | 0/8 | El endpoint en la nube respondió en la última revisión |
| Puntuación de uso | 15/100 |
Calidad: Pasó 3/3 revisiones básicas (se muestra, no ordena) · Impulso: Sin datos aún (Solo se usa en la pestaña En auge)
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala Awesome Mineflayer MCP. Sigue https://mcp.popnx.com/i/g0osey99-awesome-mineflayer-mcp.md, enséñame los comandos y espera mi OK antes de ejecutarlos.Pégala en una IA que trabaje en tu equipo (como Claude Code o Cursor). Lee nuestros pasos, te muestra los comandos y espera tu OK. Sin clave ni registro. · Ver el texto completo que lee tu IA
Pasó 3/3 revisiones · Funciona en tu computadora · ✓ Comandos revisados el 14 nov 2026
Primero: ¿qué IA usas?
Elige tu app y los pasos aparecen abajo.
Funciona con Claude, pero hay que preparar algo antes
Necesitas una clave de Awesome Mineflayer MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez) · Solo en la app de Claude para computadora (Windows o Mac), no en la web ni en el móvil
Copia este mensaje en un chat de Claude. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Awesome Mineflayer MCP para Claude en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "awesome-mineflayer": { "command": "npx", "args": [ "-y", "awesome-mineflayer-mcp" ], "env": { "MCP_DEFAULT_AUTH": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MCP_DEFAULT_AUTH deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Awesome Mineflayer MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
SettingsDeveloperEdit Config
{
"mcpServers": {
"awesome-mineflayer": {
"command": "npx",
"args": [
"-y",
"awesome-mineflayer-mcp"
],
"env": {
"MCP_DEFAULT_AUTH": "your-value"
}
}
}
}Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Awesome Mineflayer MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando Awesome Mineflayer MCP o muestra una herramienta de Awesome Mineflayer MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MCP_DEFAULT_HOST Hace que el servidor se conecte automáticamente al iniciar (opcional). MCP_DEFAULT_USERNAME Nombre en el juego (sin conexión) o correo de la cuenta (microsoft). MCP_DISABLE_GROUPS Claves de grupos de herramientas separadas por comas que se deben desactivar. MCP_READ_ONLY Modo solo observación (sin herramientas que modifiquen el entorno) MCP_ALLOWED_HOSTS Lista de permitidos separada por comas con los hosts a los que el bot puede unirse. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
ChatGPT todavía no puede conectar Awesome Mineflayer MCP
Awesome Mineflayer MCP se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
A · Usa una app que pueda conectar Awesome Mineflayer MCP
B · Otros en Otros que funcionan con ChatGPT
Elegidos entre los más usados de la misma categoría, solo los que se conectan con una dirección y sin clave
Funciona con Claude Code, pero hay que preparar algo antes
Necesitas una clave de Awesome Mineflayer MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Claude Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Awesome Mineflayer MCP para Claude Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): claude mcp add --scope user awesome-mineflayer --env MCP_DEFAULT_AUTH=your-value -- npx -y awesome-mineflayer-mcp 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MCP_DEFAULT_AUTH deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Awesome Mineflayer MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
claude mcp add --scope user awesome-mineflayer --env MCP_DEFAULT_AUTH=your-value -- npx -y awesome-mineflayer-mcpCambia “your-value” por tu clave antes de pulsar Enter
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Deberías ver Awesome Mineflayer MCP en la lista como conectado
Usa Awesome Mineflayer MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando Awesome Mineflayer MCP o muestra una herramienta de Awesome Mineflayer MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MCP_DEFAULT_HOST Hace que el servidor se conecte automáticamente al iniciar (opcional). MCP_DEFAULT_USERNAME Nombre en el juego (sin conexión) o correo de la cuenta (microsoft). MCP_DISABLE_GROUPS Claves de grupos de herramientas separadas por comas que se deben desactivar. MCP_READ_ONLY Modo solo observación (sin herramientas que modifiquen el entorno) MCP_ALLOWED_HOSTS Lista de permitidos separada por comas con los hosts a los que el bot puede unirse. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Anthropic el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con Cursor, pero hay que preparar algo antes
Necesitas una clave de Awesome Mineflayer MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de Cursor. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Awesome Mineflayer MCP para Cursor en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "mcpServers": { "awesome-mineflayer": { "command": "npx", "args": [ "-y", "awesome-mineflayer-mcp" ], "env": { "MCP_DEFAULT_AUTH": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MCP_DEFAULT_AUTH deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Awesome Mineflayer MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
En la configuración de Awesome Mineflayer MCP, MCP_DEFAULT_AUTH está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Awesome Mineflayer MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando Awesome Mineflayer MCP o muestra una herramienta de Awesome Mineflayer MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MCP_DEFAULT_HOST Hace que el servidor se conecte automáticamente al iniciar (opcional). MCP_DEFAULT_USERNAME Nombre en el juego (sin conexión) o correo de la cuenta (microsoft). MCP_DISABLE_GROUPS Claves de grupos de herramientas separadas por comas que se deben desactivar. MCP_READ_ONLY Modo solo observación (sin herramientas que modifiquen el entorno) MCP_ALLOWED_HOSTS Lista de permitidos separada por comas con los hosts a los que el bot puede unirse. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de Cursor el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Funciona con VS Code, pero hay que preparar algo antes
Necesitas una clave de Awesome Mineflayer MCP (créala en el sitio del autor) · Instala Node.js en tu computadora primero (una sola vez)
Copia este mensaje en un chat de VS Code. La IA revisa tu equipo, te dice qué archivo va a cambiar y espera tu visto bueno cada vez.
Instala el MCP server Awesome Mineflayer MCP para VS Code en este equipo, en este orden: 1) Comprueba Node.js con node -v. Si falta, dime que lo instale desde https://nodejs.org/en/download; no lo instales tú. 2) Usa solo esta configuración (ya revisada por PopNx MCP): { "servers": { "awesome-mineflayer": { "type": "stdio", "command": "npx", "args": [ "-y", "awesome-mineflayer-mcp" ], "env": { "MCP_DEFAULT_AUTH": "your-value" } } } } 3) Dime la ruta completa del archivo que vas a cambiar o el comando que vas a ejecutar y espera mi visto bueno. 4) En MCP_DEFAULT_AUTH deja "your-value" y dime que pegue yo el valor real en el archivo o en el campo de la app. Nunca me pidas escribir una clave en el chat. 5) Haz lo acordado y comprueba que las herramientas de Awesome Mineflayer MCP aparecen de verdad.Este mensaje no lleva tu clave. Si hace falta una, la IA te pedirá que la pegues tú en el archivo o en el campo de la app.
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -vMac: pulsa ⌘ + Espacio, escribe Terminal y pulsa Enter
Windows: abre Inicio, escribe Windows PowerShell y elige Abrir
Si no está instalado: Abre la página oficial de descargas, elige la versión LTS y el instalador de clics: .pkg en Mac · .msi en Windows. Haz doble clic y sigue hasta el final. No necesitas ningún comando curl
Abrir la página de descarga de Node.js ↗
Al terminar, cierra la Terminal, ábrela de nuevo y ejecuta el mismo comando. Debe aparecer un número de versión: node -v
Se instala una vez y sirve para todo lo que usa Node.js
Abre el sitio del autor, crea una cuenta y una clave de API para el siguiente paso. Consulta precios y planes gratis en su sitio.
En la configuración de Awesome Mineflayer MCP, MCP_DEFAULT_AUTH está vacío; añade tu clave y guarda
Pega la clave solo en el campo de la app; nunca en un chat ni se la envíes a nadie
Usa Awesome Mineflayer MCP y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando Awesome Mineflayer MCP o muestra una herramienta de Awesome Mineflayer MCP en la respuesta, ya está conectado
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MCP_DEFAULT_HOST Hace que el servidor se conecte automáticamente al iniciar (opcional). MCP_DEFAULT_USERNAME Nombre en el juego (sin conexión) o correo de la cuenta (microsoft). MCP_DISABLE_GROUPS Claves de grupos de herramientas separadas por comas que se deben desactivar. MCP_READ_ONLY Modo solo observación (sin herramientas que modifiquen el entorno) MCP_ALLOWED_HOSTS Lista de permitidos separada por comas con los hosts a los que el bot puede unirse. Descripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Nombres de menú comprobados con la ayuda de VS Code el 11 nov 2026 · tu pantalla puede variar un poco según la versión
Otras apps que usan MCP, como Windsurf, Zed o Gemini CLI, añaden servidores de forma distinta. Míralo en la lista de apps
Ver todas las apps que usan MCP →
La configuración JSON está en “Para desarrolladores”, abajo
Claude Code
claude mcp add --scope user awesome-mineflayer --env MCP_DEFAULT_AUTH=your-value -- npx -y awesome-mineflayer-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"awesome-mineflayer": {
"command": "npx",
"args": [
"-y",
"awesome-mineflayer-mcp"
],
"env": {
"MCP_DEFAULT_AUTH": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"awesome-mineflayer": {
"command": "npx",
"args": [
"-y",
"awesome-mineflayer-mcp"
],
"env": {
"MCP_DEFAULT_AUTH": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"awesome-mineflayer": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"awesome-mineflayer-mcp"
],
"env": {
"MCP_DEFAULT_AUTH": "your-value"
}
}
}
}MCP_DEFAULT_HOST envMCP_DEFAULT_USERNAME envMCP_DEFAULT_AUTH secreto obligatorio envMCP_DISABLE_GROUPS envMCP_READ_ONLY envMCP_ALLOWED_HOSTS envDescripciones traducidas automáticamente; los nombres de variables quedan como en el original. Si dudas, mira el original.
Esta configuración se genera a partir de la ficha del creador en el registro. Si el README dice otra cosa, sigue el README.
npm: awesome-mineflayer-mcpSegún cómo se conecta este servidor y la documentación de cada app, comprobado el 10 nov 2026.
Se ejecutan en tu computadora en
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 19 nov 2026
El nombre en el registro se verificó con la cuenta de GitHub G0Osey99, dueña del repo
Último cambio de código: hace 5 meses
Usa MIT
Este se ejecuta en tu computadora; no hay endpoint en internet
Se ejecuta en tu computadora y usa ajustes locales en su lugar
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Sin entradas en OSV.dev para awesome-mineflayer-mcp@1.3.2
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/g0osey99-awesome-mineflayer-mcp)Pregunta, comparte un consejo o avisa de que no funciona. Ordenado por lo que la gente marcó como útil.
Aún no hay publicaciones. Sé la primera persona en preguntar o compartir.
Lo publicado aquí lo escriben usuarios, no el equipo de PopNx.
Aún no hay reseñas
Comparado con todos los servidores activos de esta categoría en el registro. Las estrellas solo cuentan cuando quien lo publica es dueño del repo.
Superó 3 de 3 revisiones básicas aplicables. No hemos leído el código. Antes de agregar una clave o un token, revisa qué acceso pide el servidor y usa una clave que tenga solo los permisos que necesitas.
Debes completar: MCP_DEFAULT_AUTH
Se ejecuta en tu computadora. Tu app de IA lo inicia cuando hace falta, y los datos no pasan por los servidores del creador (a menos que el propio servidor llame a un servicio en línea).
El repo de GitHub cambió por última vez hace 5 meses, y la última versión (1.3.2) llegó al registro hace 5 meses.
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
En la misma categoría: World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
Misma categoría, otros creadores, comandos ya revisados. Primero los oficiales, luego por estrellas.
Cómo leer una tarjeta:↓ Descargas por semanai★ Estrellas de GitHubiTres pilares: reseñas · revisiones · usoiActualizado = fecha en que se publicó la última versión en el registroi
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Validate oh-my-posh configurations and segment snippets against the official schema.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
| Este Awesome Mineflayer MCP | World Monitor | openstatus | Oh My Posh Validator | Strata | Jitsu | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada | Funciona en la nube, sin instalar nada |
| Necesita clave | Sí | No | No | No | No | No |
| Se añade con + en Claude | No | No | No | No | No | No |
| Revisiones básicas | 3/3 | 4/4 | 4/4 | 4/4 | 1/4 | 4/4 |
| Licencia | MIT | AGPL-3.0 | AGPL-3.0 | MIT | Apache-2.0 | MIT |
| Precio | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro | Sin coste en el registro |
Copiado tal cual del repo del creador. PopNx MCP no lo ha revisado ni lo respalda. Se quitaron HTML, imágenes y scripts. Los enlaces llevan fuera de este sitio.
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 streaming, with full bot lifecycle management. Tool results carry both human-readable text and machine-readable structuredContent.
Backed by the Mineflayer ecosystem: mineflayer-pathfinder (A\* navigation), mineflayer-pvp (combat), mineflayer-collectblock (gathering), mineflayer-tool (auto tool-select), mineflayer-auto-eat, and mineflayer-armor-manager.
auth: "microsoft").| Supported | |
|---|---|
| Minecraft (Java) | the range supported by the bundled mineflayer 4.37 / minecraft-data (roughly 1.8 → 1.21.x); version is auto-detected, or pass version explicitly |
| Node.js | 20, 22 (LTS) |
A few tools only work on newer versions/features (e.g. elytra_fly, chat signing). On a version mismatch the bot is kicked with an outdated client/server message — pass an explicit version.
Run it on demand with npx (no install needed):
npx awesome-mineflayer-mcp
…or install it globally:
npm install -g awesome-mineflayer-mcp
awesome-mineflayer-mcp
The server speaks MCP over stdio, so it is normally launched by your MCP client rather than run by hand.
Add it to your client's MCP server configuration. The recommended form uses npx so you always get the latest published build:
Claude Desktop (claude_desktop_config.json), Claude Code, Cursor, or any stdio MCP client:
{
"mcpServers": { "mineflayer": { "command": "npx", "args": ["-y", "awesome-mineflayer-mcp"], "env": { "MCP_DISABLE_GROUPS": "" } } } }
If you installed it globally, use "command": "awesome-mineflayer-mcp" with "args": [] instead.
If you don't already have a server, spin up a throwaway offline-mode one with Docker (no account needed):
# from a clone of this repo:
docker compose up -d # offline 1.20.4 server on localhost:25565 docker compose logs -f # wait for "Done (…)! For help, type "help""
…or a one-liner without the repo:
docker run -d --name mc -p 25565:25565 -e EULA=TRUE -e ONLINE_MODE=FALSE -e VERSION=1.20.4 itzg/minecraft-server
Then connect: connect_bot { host: "localhost", username: "DevBot", auth: "offline" }. Tear it down with docker compose down -v (or docker rm -f mc). Don't expose an offline-mode server to the public internet.
For hands-off use, configure a default account so the bot connects automatically on startup — no connect_bot call required. Run the interactive setup:
npx awesome-mineflayer-mcp setup
It asks for the server host/port, an offline or Microsoft account, and whether to auto-connect on startup, then writes ~/.awesome-mineflayer-mcp/config.json (no password is stored). For a Microsoft account it runs the device-code sign-in once and caches the token under profilesFolder, so later startups need no prompt.
On startup the server auto-connects the configured account (verify with get_connection_status). The agent can also call `connect_default` to (re)connect it or `get_default_account` to inspect it.
You can set the default account entirely from your MCP client config — handy for headless deploys. Environment variables override the config file:
{
"mcpServers": { "mineflayer": { "command": "npx", "args": ["-y", "awesome-mineflayer-mcp"], "env": { "MCP_DEFAULT_HOST": "play.example.net", "MCP_DEFAULT_USERNAME": "MyBot", "MCP_DEFAULT_AUTH": "offline", "MCP_AUTO_CONNECT": "true" } } } }
For Microsoft auth in a headless setup, run setup once locally first (or point MCP_PROFILES_FOLDER at a directory with a pre-cached token).
| Variable | Default | Purpose |
|---|---|---|
MCP_DISABLE_GROUPS | _(none)_ | Comma-separated tool-group keys to disable (see catalog). Trim the surface for clients that struggle with a large tool list. |
MCP_CHARACTER_LIMIT | 25000 | Max characters returned by any single tool call (truncated with a marker). |
MCP_EVENT_BUFFER | 1000 | Size of the in-memory event ring buffer. |
MCP_THROTTLE_MS | 250 | Minimum spacing between pushed resource-update / log notifications. |
MCP_PROXIMITY_RADIUS | 32 | Radius (blocks) for proximity-filtered events (entity spawns, sounds). |
MCP_ACTION_TIMEOUT_MS | 60000 | Default timeout for long actions when the caller omits one. |
MCP_DEFAULT_HOST / MCP_DEFAULT_PORT | — | Default server to auto-connect on startup. |
MCP_DEFAULT_USERNAME | — | Default account name (offline) or email (microsoft). |
MCP_DEFAULT_AUTH | offline | Default auth mode: offline or microsoft. |
MCP_DEFAULT_VERSION | auto | Force a protocol version for the default account. |
MCP_DEFAULT_AUTO_RECONNECT | true | Auto-reconnect the default account on disconnect. |
MCP_AUTO_CONNECT | true† | Auto-connect the default on startup († when a default is configured). |
MCP_PROFILES_FOLDER | /profiles | Microsoft auth token-cache directory. |
AWESOME_MINEFLAYER_MCP_HOME | ~/.awesome-mineflayer-mcp | Config + token-cache directory. |
MCP_READ_ONLY | false | Observe-only mode: register only read-only tools (+ lifecycle). See Safety. |
MCP_COMMAND_DENY | _(admin verbs)_ | Slash commands run_command blocks. Setting it replaces the default; set empty to allow all. |
MCP_COMMAND_ALLOW | _(none)_ | If set, a strict allow-list: only these commands run (deny list ignored). |
MCP_ALLOWED_HOSTS | _(any)_ | Comma-separated allow-list of hosts the bot may connect to. |
MCP_CHAT_MIN_INTERVAL_MS | 0 | Minimum spacing between outbound chat/whisper/command sends (anti-spam). |
MCP_ENABLE_RAW | false | Enable the advanced/unsafe raw protocol tool group (direct packet send/subscribe). |
MCP_SCREENSHOT_WIDTH / _HEIGHT | 800 / 450 | Default get_screenshot image size (px). |
MCP_SCREENSHOT_LOAD_MS | 2500 | How long to let the world render before capturing a screenshot. |
MCP_VIEW_DISTANCE | 4 | Chunk render distance for screenshots. |
MCP_SCREENSHOT_BROWSER_CHANNEL | _(auto)_ | Browser channel for screenshots (chrome, msedge, chromium). |
MCP_SCREENSHOT_EXECUTABLE_PATH | _(none)_ | Explicit browser executable path for screenshots (overrides channel). |
Example — disable rarely-used groups:
MCP_DISABLE_GROUPS=creative,villager,enchanting,settings
{ host, username, auth } — connect (resolves once the bot spawns). *Skip this if you configured a default account — the bot auto-connects on startup; just check get_connection_status.*events.nextSince back each tick. Or compose `get_state` / `get_inventory` / `list_entities` / `get_events`, or subscribe to the bot://* resources.New to the server? Use the `getting_started` prompt (see Prompts) for an in-context walkthrough.
Block / item / entity arguments accept human names ("iron_ore", "diamond_pickaxe", "zombie"); unknown names return fuzzy suggestions.
auth: "offline" (default) — offline-mode servers; username is the in-game name.auth: "microsoft" — username is the account email. A device-code prompt is emitted as an msa_code event / log notification. Set `profilesFolder` to cache the token so subsequent runs skip the prompt, or pass a cached accessToken. Tip: run npx awesome-mineflayer-mcp setup once to do the device-code sign-in and cache the token, then the server connects autonomously (see Autonomous operation).Full generated reference (every tool, prompt, resource):
docs/TOOLS.md.
Group keys (for MCP_DISABLE_GROUPS) are shown in brackets.
[lifecycle] — connect_bot, connect_default, disconnect_bot, reconnect_bot, respawn, get_connection_status, get_default_account[state] (read-only) — get_observation (one-call snapshot for an agent's observe loop), get_state, get_inventory, list_players, list_entities, find_nearest_entity, get_entity_details, get_scoreboards, get_teams, get_boss_bars, get_control_states, get_chat_patterns, support_feature, pathfinder_status, get_settings, get_physics, get_loaded_plugins[world] (read-only) — get_block_at, find_blocks, get_cursor_target, get_blocks_in_region, wait_for_chunks_to_load[movement] — goto, set_goal, flee_from, follow_entity, stop_pathfinding, get_path_to, configure_movements, configure_pathfinder, set_control_state, clear_control_states, elytra_fly, wait_for_ticks, set_physics_enabled[look] — look_at, look, look_at_entity[digging] — dig, place_block, activate_block, activate_entity, swing_arm[combat] — pvp_attack, attack_entity, pvp_stop, pvp_configure[inventory] — equip_item, unequip_item, toss_item, set_quickbar_slot, consume, activate_item, click_window, move_slot_item, transfer_items[containers] — open_container, read_open_container, container_deposit, container_withdraw, close_window[furnace] — open_furnace, furnace_action, furnace_status, smelt_item[enchanting] — enchant_item, anvil_combine[villager] — open_villager, trade_with_villager[crafting] — list_recipes, craft_item[gathering] — collect_block, cancel_collect, set_collect_config[tool] — equip_tool_for_block, set_tool_chest_locations, get_best_tool[survival] — autoeat_set_enabled, autoeat_configure, autoeat_eat, autoeat_cancel, autoeat_preview, armor_equip_all[beds] — sleep, wake[vehicles] — mount_entity, dismount, steer_vehicle[fishing] — fish, cancel_fish, `wri