# BlockHand

BlockHand — MCP-сервер для Claude Code и Codex, который связывает ИИ-агента с Minecraft Education. Он управляет роботом Agent, строит формы и проверяет блоки в игровом мире.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5 у репозитория
- Автор: gjlmotea
- Лицензия: MIT · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/gjlmotea/blockhand-mcp
- Обновлён: 2026-11-02
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/mcp/blockhand

## Что делает

BlockHand передаёт команды между MCP-клиентом и Minecraft Education через встроенное WebSocket-подключение игры. Сервер умеет управлять роботом Agent, менять блоки, строить 24 формы, читать области мира и сравнивать их. Также доступны проверка симметрии и подписка на игровые события.

Для работы нужны Minecraft Education с включёнными читами и права оператора у подключающегося игрока. На компьютере с ИИ-клиентом требуется Node.js 22 или новее. Дополнение к игре устанавливать не нужно. Протокол WebSocket может измениться после обновления игры, поэтому поведение после обновлений стоит перепроверять.

## Требования
- Нужно: Node.js (команды через npx)
- Переменные окружения: `MINECRAFT_EDU_WS_PORT`, `MINECRAFT_EDU_WS_HOST` — это ключи и токены: значения спроси у человека, в репозиторий и общие файлы не записывай.

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
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-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
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-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
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-mcp
```
Вместо <…> подставьте свои значения

## Когда брать
- строить заданные формы в игровом мире
- управлять роботом Agent и сажать растения
- сравнивать области мира и находить нарушения симметрии
- читать блоки в выбранной области

## Примеры запросов агенту
- Построй передо мной полую стеклянную сферу радиусом 6.
- Вызови робота Agent, проведи его вперёд на пять блоков и посади ряд пшеницы.
- Проверь симметрию дома между координатами 0 64 0 и 20 80 20 и покажи блоки, которые её нарушают.

## Похожие
- [Context7](https://affpapa.org/nevibecode/mcp/context7.md) — MCP-сервер · 5563 установки
- [Search Google Flights](https://affpapa.org/nevibecode/mcp/search-google-flights.md) — MCP-сервер · 2595 установок
- [Math-MCP](https://affpapa.org/nevibecode/mcp/math-mcp.md) — MCP-сервер · 5958 установок
- [pipeworx gateway](https://affpapa.org/nevibecode/mcp/pipeworx-gateway.md) — MCP-сервер · 419019 установок
- [SparkForge](https://affpapa.org/nevibecode/mcp/sparkforge.md) — MCP-сервер · 219896 установок
- [OpenWebSearch](https://affpapa.org/nevibecode/mcp/openwebsearch.md) — MCP-сервер · 494 установки

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
