What it does
Minecraft Education Edition MCP server: Agent robot, 24 build shapes, events. No add-on needed.
- Connects Se ejecuta en tu computadora
- Account or key No key needed
- Category Juegos, deportes, comida y aprendizaje
Por qué está en este puesto
Las listas se ordenan por una puntuación de uso (sobre 100) con estas partes
| Popularidad | 9/80 | Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20 |
|---|---|---|
| Actualidad | 12/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 | 21/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)
Instalación
Elige la app de IA que usas y copia la configuración.
Que tu IA lo instale con una frase
Instala BlockHand. Sigue https://mcp.popnx.com/i/gjlmotea-blockhand-for-minecraft-education-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
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
Que la IA lo instale
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 BlockHand 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": { "blockhand-for-minecraft-education": { "command": "npx", "args": [ "-y", "@gjlmotea/blockhand-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) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de BlockHand 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.
Instala Node.js (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -v- Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: 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 -vSe instala una vez y sirve para todo lo que usa Node.js
Abre el archivo de configuración de la app de Claude de escritorio
SettingsDeveloperEdit Config
Pega esta configuración y guarda el archivo
{ "mcpServers": { "blockhand-for-minecraft-education": { "command": "npx", "args": [ "-y", "@gjlmotea/blockhand-mcp" ] } } }Cierra Claude y vuelve a abrirlo
Pruébalo
Usa BlockHand y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude dice que está usando BlockHand o muestra una herramienta de BlockHand en la respuesta, ya está conectado
2 ajuste(s) opcional(es) (funciona sin ellos)
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MINECRAFT_EDU_WS_PORTPuerto al que el juego se conecta con /connect (predeterminado 19131, compartido por todas las sesiones de IA).Ver original en inglés
Port the game connects to with /connect (default 19131, shared by all AI sessions)MINECRAFT_EDU_WS_HOSTDirección de escucha (predeterminado 127.0.0.1, solo loopback)Ver original en inglés
Listen address (default 127.0.0.1, loopback only)
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 BlockHand
BlockHand se instala en tu computadora, pero ChatGPT solo conecta servidores que funcionan en la web
Lo que puedes hacer en su lugar
A · Usa una app que pueda conectar BlockHand
- 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
- Instala Node.js en tu computadora primero (una sola vez)
- Instala Node.js en tu computadora primero (una sola vez)
- Instala Node.js en tu computadora primero (una sola vez)
B · Otros en Juegos, deportes, comida y aprendizaje 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
- ShipSwift✓ ChatGPT
- LearnHouse✓ ChatGPT
- Anime Garden✓ ChatGPT
Funciona con Claude Code, pero hay que preparar algo antes
Instala Node.js en tu computadora primero (una sola vez)
Que la IA lo instale
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 BlockHand 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 blockhand-for-minecraft-education -- npx -y @gjlmotea/blockhand-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) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de BlockHand 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.
Instala Node.js (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -v- Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: 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 -vSe instala una vez y sirve para todo lo que usa Node.js
Abre la Terminal
Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell
Pega este comando y pulsa Enter
claude mcp add --scope user blockhand-for-minecraft-education -- npx -y @gjlmotea/blockhand-mcpEscribe /mcp en Claude Code
Deberías ver BlockHand en la lista como conectado
Pruébalo
Usa BlockHand y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Claude Code dice que está usando BlockHand o muestra una herramienta de BlockHand en la respuesta, ya está conectado
2 ajuste(s) opcional(es) (funciona sin ellos)
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MINECRAFT_EDU_WS_PORTPuerto al que el juego se conecta con /connect (predeterminado 19131, compartido por todas las sesiones de IA).Ver original en inglés
Port the game connects to with /connect (default 19131, shared by all AI sessions)MINECRAFT_EDU_WS_HOSTDirección de escucha (predeterminado 127.0.0.1, solo loopback)Ver original en inglés
Listen address (default 127.0.0.1, loopback only)
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
Instala Node.js en tu computadora primero (una sola vez)
Que la IA lo instale
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 BlockHand 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": { "blockhand-for-minecraft-education": { "command": "npx", "args": [ "-y", "@gjlmotea/blockhand-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) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de BlockHand 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.
Instala Node.js (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -v- Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: 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 -vSe instala una vez y sirve para todo lo que usa Node.js
Abre el chat de IA de Cursor en modo Agent
Pruébalo
Usa BlockHand y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si Cursor dice que está usando BlockHand o muestra una herramienta de BlockHand en la respuesta, ya está conectado
2 ajuste(s) opcional(es) (funciona sin ellos)
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MINECRAFT_EDU_WS_PORTPuerto al que el juego se conecta con /connect (predeterminado 19131, compartido por todas las sesiones de IA).Ver original en inglés
Port the game connects to with /connect (default 19131, shared by all AI sessions)MINECRAFT_EDU_WS_HOSTDirección de escucha (predeterminado 127.0.0.1, solo loopback)Ver original en inglés
Listen address (default 127.0.0.1, loopback only)
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
Instala Node.js en tu computadora primero (una sola vez)
Que la IA lo instale
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 BlockHand 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": { "blockhand-for-minecraft-education": { "type": "stdio", "command": "npx", "args": [ "-y", "@gjlmotea/blockhand-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) No hace falta clave. 5) Haz lo acordado y comprueba que las herramientas de BlockHand 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.
Instala Node.js (si no lo tienes)
¿Ya está instalado? Compruébalo primero · Abre la Terminal, escribe este comando y pulsa Enter
node -v- Aparece un número de versión, p. ej. v26.13.1 = ya está instalado, sáltate este paso
- Aparece "command not found" (en Windows, "is not recognized") = aún no está instalado, o acabas de instalarlo y debes cerrar y volver a abrir la Terminal
Cómo abrir la Terminal
Mac: 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 -vSe instala una vez y sirve para todo lo que usa Node.js
Abre el chat de IA de VS Code en modo Agent
Pruébalo
Usa BlockHand y dime qué puedes hacer por mí; luego muéstrame una cosa✓ Si VS Code dice que está usando BlockHand o muestra una herramienta de BlockHand en la respuesta, ya está conectado
2 ajuste(s) opcional(es) (funciona sin ellos)
El comando de arriba funciona sin estos valores. Añádelos solo si quieres cambiar algo, según la descripción del autor.
MINECRAFT_EDU_WS_PORTPuerto al que el juego se conecta con /connect (predeterminado 19131, compartido por todas las sesiones de IA).Ver original en inglés
Port the game connects to with /connect (default 19131, shared by all AI sessions)MINECRAFT_EDU_WS_HOSTDirección de escucha (predeterminado 127.0.0.1, solo loopback)Ver original en inglés
Listen address (default 127.0.0.1, loopback only)
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
Para desarrolladores: comandos de Terminal y configuración JSON
Instalado en tu computadora
Claude Code
claude mcp add --scope user blockhand-for-minecraft-education -- npx -y @gjlmotea/blockhand-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"blockhand-for-minecraft-education": {
"command": "npx",
"args": [
"-y",
"@gjlmotea/blockhand-mcp"
]
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"blockhand-for-minecraft-education": {
"command": "npx",
"args": [
"-y",
"@gjlmotea/blockhand-mcp"
]
}
}
}VS Code (mcp.json)
{
"servers": {
"blockhand-for-minecraft-education": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@gjlmotea/blockhand-mcp"
]
}
}
}Valores que debes completar
MINECRAFT_EDU_WS_PORTenvPuerto al que el juego se conecta con /connect (predeterminado 19131, compartido por todas las sesiones de IA).Ver original en inglés
Port the game connects to with /connect (default 19131, shared by all AI sessions)MINECRAFT_EDU_WS_HOSTenvDirección de escucha (predeterminado 127.0.0.1, solo loopback)Ver original en inglés
Listen address (default 127.0.0.1, loopback only)
Descripciones 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.
De un vistazo
- Descargas por semanai
- 66/sem
- Conexión
- Se ejecuta en tu computadora
- Última versióni
- 0.1.1
- Publicado en el registroi
- 19 oct 2026
- Último cambio de códigoi
- 2 nov 2026
- Creador
- gjlmotea
- Paquetes
npm: @gjlmotea/blockhand-mcp- Sitio web
- github.com
- Estado en el registro
- Activo
Qué apps pueden usarlo
Segú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
Qué puede hacer
Se ejecuta en tu computadora; la lista de herramientas aparece en tu app de IA después de instalarlo.
Revisiones básicasi
Revisamos información que cualquiera puede ver; no hemos leído el código. Las revisiones que no aplican no se cuentan. · Revisado el 20 nov 2026
- ✓ Superada
El creador coincide con el repo
El nombre en el registro se verificó con la cuenta de GitHub gjlmotea, dueña del repo
- ✓ Superada
Sigue en mantenimiento
Último cambio de código: hace 18 días
- ✓ Superada
Tiene licencia
Usa MIT
- – No aplica
El endpoint responde
Este se ejecuta en tu computadora; no hay endpoint en internet
- – No aplica
Inicio de sesión con OAuth
Se ejecuta en tu computadora y usa ajustes locales en su lugar
- … Aún sin revisar
Sin instrucciones ocultas en las descripciones de herramientas
Se ejecuta en tu computadora; solo podemos leer listas de herramientas de endpoints en internet
Vulnerabilidades publicadas (OSV.dev)
Sin entradas en OSV.dev para @gjlmotea/blockhand-mcp@0.1.1
Solo revisa esta versión del paquete, no todas sus dependencias · revisado 15 nov 2026
Creadores: pedir otra revisión o avisar de un dato erróneo
Para autores: añade una insignia a tu README
Si lo creaste tú, pega este código en tu README. La insignia enlaza a esta página.
[](https://mcp.popnx.com/en/servers/gjlmotea-blockhand-for-minecraft-education-mcp)Conversación
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.
Reseñas de usuarios
Aún no hay reseñas
Comparado con otros en Juegos, deportes, comida y aprendizajei
- Más estrellas que el 94% de los otros 1623 servidores de esta categoría
- Publicado en el registro más recientemente que el 45% de los otros 1623 servidores de esta categoría
- Revisiones básicas iguales o mejores que el 99% de los otros 1623 servidores de esta categoría
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.
Preguntas frecuentes
¿Es seguro BlockHand?
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.
¿Qué claves o códigos necesita?
El registro no indica ninguna clave obligatoria, aunque algunos servidores te piden iniciar sesión la primera vez que los usas.
¿Se ejecuta en mi computadora o en la nube?
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).
¿Sigue en mantenimiento?
El repo de GitHub cambió por última vez hace 18 días, y la última versión (0.1.1) llegó al registro hace 32 días.
¿Qué apps pueden usarlo?
Las apps compatibles con MCP, como Claude Desktop, Claude Code, Cursor y VS Code. También necesitas Node.js en tu computadora.
¿Qué puedo usar en su lugar?
En la misma categoría: Anime Garden, WilmAI, Lumify Sports Intelligence, Savecraft, GoodWatch
Alternativas parecidas
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
WilmAI
Finland's Wilma school system for parents and students: schedule, homework, exams and messages.
Lumify Sports Intelligence
Schedules, scores, odds, splits & explainable AI bet confidence — 8+ sports, free instant key.
Savecraft
Savecraft serves real save game data and expert game knowledge to AI assistants.
GoodWatch
Find movies and TV shows, track watches, and get suggestions based on your taste.
| Este BlockHand | Anime Garden | WilmAI | Lumify Sports Intelligence | Savecraft | GoodWatch | |
|---|---|---|---|---|---|---|
| Dónde se ejecuta | Se instala en tu equipo | Funciona en la nube, sin instalar nada | 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 |
| Necesita clave | No | No | No | Sí | No | No |
| Se añade con + en Claude | No | No | No | No | No | No |
| Revisiones básicas | 3/3 | 4/4 | 3/3 | 4/4 | 3/4 | 4/4 |
| Licencia | MIT | AGPL-3.0 | MIT | 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 |
README del creador
Abrir el README
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.
BlockHand — MCP server for Minecraft Education
English | 繁體中文
BlockHand gives AI agents hands and eyes inside Minecraft Education Edition. Claude Code, Codex, Gemini CLI, Grok or any other Model Context Protocol client can drive the Agent robot, build structures, read blocks, compare regions and react to game events.
It talks to the game only through Minecraft Education's built-in /connect (/wsserver) WebSocket command. There is no add-on, behavior pack, mod or Script API to install in the game, nothing is injected into the game process, and no screen reading is involved. On a school computer, the only thing to install is the AI client.
- 44 tools and 2 resources: Agent robot control, world edits, 24 build shapes, blueprints, block reading, region comparison, symmetry checks and event subscription.
- Fast building: shapes are merged into the fewest possible
/fillcommands (a solid sphere of radius 8 goes from 2,000+ blocks to under 200 commands). - Local by default: the game WebSocket listens on
127.0.0.1unlessMINECRAFT_EDU_WS_HOSTchanges it, and no account or online service is involved. - One fixed address: every AI session on the machine shares one background hub, so the game always connects with
/connect 127.0.0.1:19131. - Hands-off by design: the agent reloads packs, rejoins the world and restarts a hung game by itself instead of asking the player to. The player is needed only to sign in. See Hands-off operation.
- Installers for Claude Code, Codex, Gemini CLI and Grok CLI when you run from source.
The
/connectcommand is an official interface. The WebSocket message protocol behind it has no published stability guarantee, so behavior should be re-checked after game updates.
Contents
- Quick start
- Install from source
- Tools
- Connecting and staying connected
- Hands-off operation
- How building stays fast
- Reading blocks
- Undo (off by default)
- Configuration
- Safety
- Troubleshooting
- Known limitations
- Development
- License and trademarks
Quick start
Requirements:
- Minecraft Education Edition, in a world with Cheats on. The player who connects needs operator rights. Verified on 1.26.32 (Windows desktop and macOS 14+).
- Node.js 22 or newer on the machine that runs the AI client.
1. Register the server with your AI client
Claude Code:
claude mcp add blockhand --scope user -- npx -y @gjlmotea/blockhand-mcp
Codex:
codex mcp add blockhand -- npx -y @gjlmotea/blockhand-mcp
Clients that read an mcpServers JSON config (Claude Desktop, Cursor, Gemini CLI):
{
"mcpServers": { "blockhand": { "command": "npx", "args": ["-y", "@gjlmotea/blockhand-mcp"] } } }
VS Code uses a top-level servers key instead, and each server has a type:
{
"servers": { "blockhand": { "type": "stdio", "command": "npx", "args": ["-y", "@gjlmotea/blockhand-mcp"] } } }
Where each client keeps the file:
| Client | Config file |
|---|---|
| Claude Desktop | macOS: ~/Library/Application Support/Claude/claude_desktop_config.json; Windows: %APPDATA%\Claude\claude_desktop_config.json. Settings → Developer → Edit Config opens it |
| Cursor | ~/.cursor/mcp.json for every project, .cursor/mcp.json inside one project |
| Gemini CLI | ~/.gemini/settings.json (user), .gemini/settings.json (project) |
| VS Code | .vscode/mcp.json in the workspace, or the user mcp.json that the MCP: Open User Configuration command opens |
Sources: Claude Desktop, Cursor, Gemini CLI, VS Code.
Desktop apps started from Finder or the Start menu often do not see your shell's PATH. If the server fails to start with a vague "server not responding" error, replace npx with its absolute path (which npx on macOS, where npx on Windows).
Restart the AI client after registering.
2. Connect the game
The game connects to the server, not the other way round.
- Open a world in Minecraft Education. The main menu is not enough.
- Make sure Cheats are on.
- Type in the chat:
/connect 127.0.0.1:19131
If your agent can send keys to the game window (see Hands-off operation), it types this itself; it reads the exact command from mc_status.
When the connection is made, a green "✔ BlockHand connected" line appears in the chat, in the game's own language: English, Traditional Chinese or Simplified Chinese, and English for any other game language. You can also ask the AI to call mc_status, which returns the exact connectCommand.
3. Ask for something
Build a hollow glass sphere with radius 6 in front of me.
Summon the Agent, walk it five blocks forward and plant a row of wheat.
Check whether the house at 0 64 0 to 20 80 20 is mirror-symmetric and show me which blocks break the symmetry.
Install from source
Use this route to work on BlockHand itself, or to use the installers and the doctor check.
git clone https://github.com/gjlmotea/blockhand-mcp.git
cd blockhand-mcp corepack pnpm install --frozen-lockfile corepack pnpm run build
Register with one of the installers:
corepack pnpm run setup:claude # or setup:codex / setup:gemini / setup:grok
corepack pnpm run doctor # add --client=claude etc. to check another client
The installers do more than write a config entry:
- They fill in the absolute path of this machine's Node, so desktop apps that cannot read nvm, Homebrew or your shell
PATHstill start the server. - Before changing any setting, they run a real MCP
initializewith the exact command, arguments and environment they are about to save, and check that all 44 tools are there. - They do nothing when the server is already registered correctly, so re-running is safe.
- When an entry with the same name exists but differs, they stop and show the difference instead of overwriting someone else's settings.
- They write only through each client's official
mcp add/mcp removecommand, never by editing config files directly.
Remove with corepack pnpm run uninstall:claude (or uninstall:codex, and so on). It refuses to remove entries it cannot identify as belonging to this checkout.
| Client | Writes to | Then |
|---|---|---|
| Codex | ~/.codex/config.toml | Quit and restart; desktop app, CLI and IDE share it |
| Claude Code | ~/.claude.json (user scope) | Restart the session |
| Gemini CLI | ~/.gemini/settings.json (user scope) | Restart the CLI |
| Grok CLI | ~/.grok/config.toml | Restart the CLI |
To register by hand, point the client at /dist/index.js, where is the absolute path from node -p "process.execPath" and is the absolute path of the checkout. Claude Code and Gemini CLI place the command differently:
claude mcp add blockhand --scope user -- <NODE> <REPO>/dist/index.js
gemini mcp add --scope user blockhand /dist/index.js
Claude Code wants -- before the command. Gemini CLI takes the command right after the name (gemini mcp add [options] [args...]); a -- there would leave it without a command. Gemini only needs -- after the command, in front of server arguments that collide with its own options, and BlockHand takes no arguments. Gemini's default scope is project, so use --scope user to make it global. Claude Code's default scope is local; --scope project writes a shareable .mcp.json, which is handy for a whole class. Sources: Claude Code, Gemini CLI.
Tools
Connection and fallback (6)
| Tool | Purpose |
|---|---|
mc_status | Bridge state, the /connect command, subscribed events, command counters. Check this first when anything fails |
mc_await_connection | Wait for the game to connect (up to 120 seconds per call) |
mc_run_command | One raw slash command, for anything without a dedicated tool |
mc_run_commands | Several raw commands in order |
mc_undo_control | Inspect, clear or configure single-step undo (off by default) |
mc_undo | Undo the last protected build, after checking for conflicting changes |
Agent robot (10)
| Tool | Purpose |
|---|---|
mc_agent_create | Summon the Agent |
mc_agent_move | Walk N blocks in a direction |
mc_agent_turn | Turn left or right by 90 degrees |
mc_agent_teleport | Bring a lost Agent back to the player |
mc_agent_act | Attack, destroy or till, optionally repeated |
mc_agent_place | Place a block from an inventory slot |
mc_agent_collect | Pick up dropped items |
mc_agent_inventory | Count, free space, item detail, drop, drop all, transfer |
mc_agent_sense | Inspect, inspect data, detect, detect redstone: the Agent's eyes |
mc_agent_program | Send a whole sequence of actions in one call and get a result per step |
Agent directions are relative to the way the Agent is facing, not compass directions.
World (13)
mc_set_block, mc_fill, mc_clone, mc_test_block, mc_read_block, mc_verify_reading, mc_compare_regions, mc_analyze_symmetry, mc_query_target, mc_summon, mc_world_settings (time, weather, game rules, difficulty), mc_structure (save and load structures), mc_ticking_area.
mc_query_target parses the JSON that querytarget returns. It is the way to find where the player or the Agent is before building.
mc_compare_regions compares two regions with a single testforblocks. Its masked mode ignores air in the source, which is how you check that a student's build contains everything it should, whatever else is around it.
mc_analyze_symmetry checks whether a region is mirror-symmetric and, when it is not, points to the cells that differ. It works by saving the region, loading a mirrored copy into a scratch area, comparing, and restoring the scratch area afterwards. The scratch area may not overlap the region being analyzed; this is checked before any command is sent. If backing up the scratch area fails, nothing is placed.
mc_structure saves to memory by default (gone when the game closes). Use saveMode: "disk" only when the user asks to keep a structure; it writes into the world folder. The game has no command that lists saved structures, so mc_status reports the names saved during the current session.
Player and feedback (7)
mc_teleport, mc_give, mc_gamemode, mc_effect, mc_player_action (kill, clear, xp, ability), mc_message (say, tell, title, subtitle, action bar), mc_feedback (sounds and particles).
Building (4)
| Tool | Purpose |
|---|---|
mc_build_preview | Plan only: block count, bounding box, number of /fill batches |
mc_build_shape | 24 geometric shapes; most support hollow |
mc_blueprint_preview | Preview a block-by-block blueprint |
mc_build_blueprint | Any shape from a list of "coordinate → block"; identical blocks are merged |
| Group | Shapes |
|---|---|
| Solids | box, sphere, ellipsoid, cylinder, cone, pyramid, prism |
|