BlockHand — Claude Code MCP server: features and setup
BlockHand is an MCP server for Claude Code and Codex that connects an AI agent to Minecraft Education. It controls the Agent robot, builds shapes, and inspects blocks in the world.
MIT ★ 5 updated 2026-11-02
claude mcp add --env MINECRAFT_EDU_WS_PORT=<MINECRAFT_EDU_WS_PORT> --env MINECRAFT_EDU_WS_HOST=<MINECRAFT_EDU_WS_HOST> --transport stdio blockhand -- npx -y @gjlmotea/blockhand-mcpWhat BlockHand does
BlockHand passes commands between an MCP client and Minecraft Education through the game’s built-in WebSocket connection. It can control the Agent robot, edit blocks, build 24 shapes, read areas, and compare regions. It also checks symmetry and listens for game events.
Minecraft Education must have cheats enabled, and the connecting player needs operator rights. Node.js 22 or newer is required on the machine running the AI client. No game add-on is needed. The WebSocket protocol may change with game updates, so behavior needs another check after an update.
What it helps with
- build specified shapes in a game world
- direct the Agent robot and plant crops
- compare world regions and find symmetry breaks
- read blocks in a selected area
Example prompts for the agent
- Call the Agent, move it forward five blocks, and plant a row of wheat.
- Check the house between coordinates 0 64 0 and 20 80 20 for mirror symmetry, then show the blocks that break it.
How to install BlockHand
Platform CLI
claude mcp add --env MINECRAFT_EDU_WS_PORT=<MINECRAFT_EDU_WS_PORT> --env MINECRAFT_EDU_WS_HOST=<MINECRAFT_EDU_WS_HOST> --transport stdio blockhand -- npx -y @gjlmotea/blockhand-mcpReplace <…> with your own values
Platform CLI
codex mcp add blockhand --env MINECRAFT_EDU_WS_PORT=<MINECRAFT_EDU_WS_PORT> --env MINECRAFT_EDU_WS_HOST=<MINECRAFT_EDU_WS_HOST> -- npx -y @gjlmotea/blockhand-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"blockhand": {
"command": "npx",
"args": [
"-y",
"@gjlmotea/blockhand-mcp"
],
"env": {
"MINECRAFT_EDU_WS_PORT": "<MINECRAFT_EDU_WS_PORT>",
"MINECRAFT_EDU_WS_HOST": "<MINECRAFT_EDU_WS_HOST>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"blockhand": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@gjlmotea/blockhand-mcp"
],
"env": {
"MINECRAFT_EDU_WS_PORT": "<MINECRAFT_EDU_WS_PORT>",
"MINECRAFT_EDU_WS_HOST": "<MINECRAFT_EDU_WS_HOST>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e MINECRAFT_EDU_WS_PORT=<MINECRAFT_EDU_WS_PORT> -e MINECRAFT_EDU_WS_HOST=<MINECRAFT_EDU_WS_HOST> blockhand npx -y @gjlmotea/blockhand-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about BlockHand
How do I install BlockHand in Claude Code?
Run claude mcp add blockhand-for-minecraft-education-mcp -- npx -y @gjlmotea/blockhand-mcp, then restart Claude Code.
What does BlockHand do?
It links an MCP client to Minecraft Education so an agent can control the Agent robot, build shapes, inspect blocks, and compare parts of the world.
What does BlockHand need to run?
Minecraft Education must have cheats enabled, the connecting player needs operator rights, and the AI client’s machine needs Node.js 22 or newer.