# Minecraft

MCP-сервер связывает ИИ-агента с Minecraft через WorldAPI: он читает данные мира и выполняет разрешённые действия. Подходит для проверки сервера и управления им из чата.

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

## Что делает

Агент получает доступ к данным о игроках, мирах, блоках, сундуках, сущностях, рецептах, настройках и журналах. Среди доступных действий — запуск команд и Java-скриптов, чтение инвентарей, а также изменение конфигурации, если это разрешает токен. Сервер также может сообщать о событиях, например о входе игрока.

Для работы нужен WorldAPI на сервере Paper, Fabric или NeoForge; для одиночной игры требуется мод WorldAPI в игровом мире. MCP-сервер подключается к WorldAPI через Claude Code, Codex, Cursor и другие перечисленные MCP-клиенты. Права токена определяют, какие инструменты увидит агент: токен только для чтения скрывает операции записи, а токен зрителя открывает 17 инструментов для просмотра. Без настроенного WorldAPI подключаться не к чему.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add --env WORLDAPI_URL=<WORLDAPI_URL> --env WORLDAPI_TOKEN=<WORLDAPI_TOKEN> --env WORLDAPI_READ_ONLY=<WORLDAPI_READ_ONLY> --transport stdio minecraft -- npx -y @mairwunnx/minecraft-mcp
```
Вместо <…> подставьте свои значения

### Codex

**Командой платформы**
```bash
codex mcp add minecraft --env WORLDAPI_URL=<WORLDAPI_URL> --env WORLDAPI_TOKEN=<WORLDAPI_TOKEN> --env WORLDAPI_READ_ONLY=<WORLDAPI_READ_ONLY> -- npx -y @mairwunnx/minecraft-mcp
```
Вместо <…> подставьте свои значения

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "minecraft": {
            "command": "npx",
            "args": [
                "-y",
                "@mairwunnx/minecraft-mcp"
            ],
            "env": {
                "WORLDAPI_URL": "<WORLDAPI_URL>",
                "WORLDAPI_TOKEN": "<WORLDAPI_TOKEN>",
                "WORLDAPI_READ_ONLY": "<WORLDAPI_READ_ONLY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "minecraft": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@mairwunnx/minecraft-mcp"
            ],
            "env": {
                "WORLDAPI_URL": "<WORLDAPI_URL>",
                "WORLDAPI_TOKEN": "<WORLDAPI_TOKEN>",
                "WORLDAPI_READ_ONLY": "<WORLDAPI_READ_ONLY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e WORLDAPI_URL=<WORLDAPI_URL> -e WORLDAPI_TOKEN=<WORLDAPI_TOKEN> -e WORLDAPI_READ_ONLY=<WORLDAPI_READ_ONLY> minecraft npx -y @mairwunnx/minecraft-mcp
```
Вместо <…> подставьте свои значения

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

## Примеры запросов агенту
- Покажи, кто сейчас на сервере и где находятся игроки.
- Проверь журналы и выясни, из-за чего сервер тормозит.
- Сообщи мне, когда Steve зайдёт на сервер.

## Похожие
- [Pascal 3D Editor](https://affpapa.org/nevibecode/mcp/pascal-3d-editor.md) — MCP-сервер · ★ 25137
- [Unity-MCP](https://affpapa.org/nevibecode/mcp/unity-mcp.md) — MCP-сервер · ★ 4534
- [mcp](https://affpapa.org/nevibecode/mcp/sceneview-mcp.md) — MCP-сервер · ★ 1349
- [Gearboy MCP Server](https://affpapa.org/nevibecode/mcp/gearboy-mcp-server.md) — MCP-сервер · ★ 1218
- [ChiR24-unreal_mcp_server](https://affpapa.org/nevibecode/mcp/chir24-unreal-mcp-server.md) — MCP-сервер · ★ 982
- [Nova3D](https://affpapa.org/nevibecode/mcp/nova3d.md) — MCP-сервер · ★ 732

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