Prototipo · Versión preliminar: todos los servidores del registro oficial, sincronizados cada 30 minutos. Inicia sesión con Google para escribir reseñas.Prototipo · se actualiza cada 30 min
PopNx MCPServidores MCP para quienes usan IA · en palabras sencillas

BlockHand

de gjlmoteaversión 0.1.1i★ 5iSe ejecuta en tu computadoraRepositorio ↗
Nombre en el registroio.github.gjlmotea/blockhand-for-minecraft-education-mcp

Cómo instalar

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

Popularidad9/80Estrellas de GitHub o descargas semanales: la mayor cuenta 60, la menor 20
Actualidad12/12Puntuación completa con una versión o cambio de código en 30 días
Sigue respondiendo0/8El endpoint en la nube respondió en la última revisión
Puntuación de uso21/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.

  1. 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 -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre el archivo de configuración de la app de Claude de escritorio

    SettingsDeveloperEdit Config

  3. Pega esta configuración y guarda el archivo

    {
      "mcpServers": {
        "blockhand-for-minecraft-education": {
          "command": "npx",
          "args": [
            "-y",
            "@gjlmotea/blockhand-mcp"
          ]
        }
      }
    }
  4. Cierra Claude y vuelve a abrirlo

  5. 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_PORT Puerto al que el juego se conecta con /connect (predeterminado 19131, compartido por todas las sesiones de IA).
    Ver original en inglésPort the game connects to with /connect (default 19131, shared by all AI sessions)
  • MINECRAFT_EDU_WS_HOST Dirección de escucha (predeterminado 127.0.0.1, solo loopback)
    Ver original en inglésListen 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

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.

  1. 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 -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Abre la Terminal

    Mac: pulsa Command+Espacio y escribe Terminal · Windows: abre PowerShell

  3. Pega este comando y pulsa Enter

    claude mcp add --scope user blockhand-for-minecraft-education -- npx -y @gjlmotea/blockhand-mcp
  4. Escribe /mcp en Claude Code

    Deberías ver BlockHand en la lista como conectado

  5. 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_PORT Puerto al que el juego se conecta con /connect (predeterminado 19131, compartido por todas las sesiones de IA).
    Ver original en inglésPort the game connects to with /connect (default 19131, shared by all AI sessions)
  • MINECRAFT_EDU_WS_HOST Dirección de escucha (predeterminado 127.0.0.1, solo loopback)
    Ver original en inglésListen 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.

  1. 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 -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir Cursor

    Abrir en Cursor

    Cursor te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de Cursor en modo Agent

  4. 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_PORT Puerto al que el juego se conecta con /connect (predeterminado 19131, compartido por todas las sesiones de IA).
    Ver original en inglésPort the game connects to with /connect (default 19131, shared by all AI sessions)
  • MINECRAFT_EDU_WS_HOST Dirección de escucha (predeterminado 127.0.0.1, solo loopback)
    Ver original en inglésListen 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.

  1. 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 -v

    Se instala una vez y sirve para todo lo que usa Node.js

  2. Pulsa este botón para abrir VS Code

    Abrir en VS Code

    VS Code te pedirá confirmar; pulsa Install

  3. Abre el chat de IA de VS Code en modo Agent

  4. 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_PORT Puerto al que el juego se conecta con /connect (predeterminado 19131, compartido por todas las sesiones de IA).
    Ver original en inglésPort the game connects to with /connect (default 19131, shared by all AI sessions)
  • MINECRAFT_EDU_WS_HOST Dirección de escucha (predeterminado 127.0.0.1, solo loopback)
    Ver original en inglésListen 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

¿Te atascaste? Pregunta a quien usa BlockHand💬 Conversación →
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-mcp

Claude 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_PORT env
    Puerto al que el juego se conecta con /connect (predeterminado 19131, compartido por todas las sesiones de IA).
    Ver original en inglésPort the game connects to with /connect (default 19131, shared by all AI sessions)
  • MINECRAFT_EDU_WS_HOST env
    Dirección de escucha (predeterminado 127.0.0.1, solo loopback)
    Ver original en inglésListen 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

Todas las apps, con ventajas y desventajas →

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

Qué revisamos → · JSON

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.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/gjlmotea-blockhand-for-minecraft-education-mcp.svg)](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.

Inicia sesión para publicar

Reseñas de usuarios

Aún no hay reseñas

Inicia sesión para escribir una reseña

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

Anime Garden

Anime Garden MCP for anime torrent discovery.

de yjl9903En crecimiento★ 1,4 milActualizado hace 16 días

Se ejecuta en la nube✓ animes.garden

WilmAI

Finland's Wilma school system for parents and students: schedule, homework, exams and messages.

de aikarjalEn crecimiento↓ 1,4 mil/sem★ 89 Estrellas de todo el repositorioActualizado hace 11 días

Se ejecuta en tu computadora✓ del servicio · wilm.ai

Savecraft

Savecraft serves real save game data and expert game knowledge to AI assistants.

de joshsymondsInicial★ 13Actualizado hace 7 meses

Se ejecuta en la nubeRepo archivado✓ del servicio · savecraft.gg

GoodWatch

Find movies and TV shows, track watches, and get suggestions based on your taste.

de alp82Inicial★ 50 Estrellas de todo el repositorioActualizado hace 31 días

Se ejecuta en la nube✓ del servicio · goodwatch.app
Comparado con otros parecidos
Este
BlockHand
Anime GardenWilmAILumify Sports IntelligenceSavecraftGoodWatch
Dónde se ejecutaSe instala en tu equipoFunciona en la nube, sin instalar nadaSe instala en tu equipoFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nadaFunciona en la nube, sin instalar nada
Necesita claveNoNoNoSíNoNo
Se añade con + en ClaudeNoNoNoNoNoNo
Revisiones básicas3/34/43/34/43/44/4
LicenciaMITAGPL-3.0MITMITApache-2.0MIT
PrecioSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin coste en el registroSin 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 /fill commands (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.1 unless MINECRAFT_EDU_WS_HOST changes 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 /connect command 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:

ClientConfig file
Claude DesktopmacOS: ~/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.

  1. Open a world in Minecraft Education. The main menu is not enough.
  2. Make sure Cheats are on.
  3. 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 PATH still start the server.
  • Before changing any setting, they run a real MCP initialize with 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 remove command, 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.

ClientWrites toThen
Codex~/.codex/config.tomlQuit 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.tomlRestart 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)
ToolPurpose
mc_statusBridge state, the /connect command, subscribed events, command counters. Check this first when anything fails
mc_await_connectionWait for the game to connect (up to 120 seconds per call)
mc_run_commandOne raw slash command, for anything without a dedicated tool
mc_run_commandsSeveral raw commands in order
mc_undo_controlInspect, clear or configure single-step undo (off by default)
mc_undoUndo the last protected build, after checking for conflicting changes
Agent robot (10)
ToolPurpose
mc_agent_createSummon the Agent
mc_agent_moveWalk N blocks in a direction
mc_agent_turnTurn left or right by 90 degrees
mc_agent_teleportBring a lost Agent back to the player
mc_agent_actAttack, destroy or till, optionally repeated
mc_agent_placePlace a block from an inventory slot
mc_agent_collectPick up dropped items
mc_agent_inventoryCount, free space, item detail, drop, drop all, transfer
mc_agent_senseInspect, inspect data, detect, detect redstone: the Agent's eyes
mc_agent_programSend 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)
ToolPurpose
mc_build_previewPlan only: block count, bounding box, number of /fill batches
mc_build_shape24 geometric shapes; most support hollow
mc_blueprint_previewPreview a block-by-block blueprint
mc_build_blueprintAny shape from a list of "coordinate → block"; identical blocks are merged
GroupShapes
Solidsbox, sphere, ellipsoid, cylinder, cone, pyramid, prism

|

Solo se muestra el principio; lee el resto en el repo