# Awesome Mineflayer MCP

Даёт агенту управление ботом Mineflayer: ходить, копать, крафтить, драться, строить. Ставится в Claude, Cursor, Codex и другие MCP-клиенты.

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

## Что делает

Сервер держит подключение к серверу Minecraft Java Edition через Mineflayer и отдаёт агенту 123 типизированных инструмента в 26 группах. Движение, добыча, инвентарь, бой, контейнеры, чат, макросы на постройку и копку, точки-метки. Отдельно идут скриншоты от первого лица и схематичные карты — агент смотрит, что получилось. Результаты инструментов содержат и текст для человека, и `structuredContent` для машины.

Навигация и поведение опираются на пакеты экосистемы: `mineflayer-pathfinder` для поиска пути, `mineflayer-pvp` для боя, `mineflayer-collectblock` для сбора, `mineflayer-auto-eat` и `mineflayer-armor-manager`. Нужен Node.js 20 или новее и работающий сервер Minecraft. Для online-mode сервера понадобится аккаунт Microsoft с `auth: "microsoft"`.

Версии игры определяются автоматически, но часть инструментов вроде `elytra_fly` работает только на новых версиях. При несовпадении бота выкинет с сообщением про outdated client или server — тогда версию задают явно. Есть `MCP_READ_ONLY` для режима только чтения и фильтры `MCP_COMMAND_DENY` и `MCP_COMMAND_ALLOW` на слэш-команды. Ограничения по хостам задаёт `MCP_ALLOWED_HOSTS`: без него бот пойдёт на любой адрес.

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

## Установка

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

**Командой платформы**
```bash
claude mcp add --env MCP_DEFAULT_HOST=<MCP_DEFAULT_HOST> --env MCP_DEFAULT_USERNAME=<MCP_DEFAULT_USERNAME> --env MCP_DEFAULT_AUTH=<MCP_DEFAULT_AUTH> --env MCP_DISABLE_GROUPS=<MCP_DISABLE_GROUPS> --env MCP_READ_ONLY=<MCP_READ_ONLY> --transport stdio awesome-mineflayer-mcp -- npx -y awesome-mineflayer-mcp
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### Codex

**Командой платформы**
```bash
codex mcp add awesome-mineflayer-mcp --env MCP_DEFAULT_HOST=<MCP_DEFAULT_HOST> --env MCP_DEFAULT_USERNAME=<MCP_DEFAULT_USERNAME> --env MCP_DEFAULT_AUTH=<MCP_DEFAULT_AUTH> --env MCP_DISABLE_GROUPS=<MCP_DISABLE_GROUPS> --env MCP_READ_ONLY=<MCP_READ_ONLY> -- npx -y awesome-mineflayer-mcp
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "awesome-mineflayer-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "awesome-mineflayer-mcp"
            ],
            "env": {
                "MCP_DEFAULT_HOST": "<MCP_DEFAULT_HOST>",
                "MCP_DEFAULT_USERNAME": "<MCP_DEFAULT_USERNAME>",
                "MCP_DEFAULT_AUTH": "<MCP_DEFAULT_AUTH>",
                "MCP_DISABLE_GROUPS": "<MCP_DISABLE_GROUPS>",
                "MCP_READ_ONLY": "<MCP_READ_ONLY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "awesome-mineflayer-mcp": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "awesome-mineflayer-mcp"
            ],
            "env": {
                "MCP_DEFAULT_HOST": "<MCP_DEFAULT_HOST>",
                "MCP_DEFAULT_USERNAME": "<MCP_DEFAULT_USERNAME>",
                "MCP_DEFAULT_AUTH": "<MCP_DEFAULT_AUTH>",
                "MCP_DISABLE_GROUPS": "<MCP_DISABLE_GROUPS>",
                "MCP_READ_ONLY": "<MCP_READ_ONLY>"
            }
        }
    }
}
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add -e MCP_DEFAULT_HOST=<MCP_DEFAULT_HOST> -e MCP_DEFAULT_USERNAME=<MCP_DEFAULT_USERNAME> -e MCP_DEFAULT_AUTH=<MCP_DEFAULT_AUTH> -e MCP_DISABLE_GROUPS=<MCP_DISABLE_GROUPS> -e MCP_READ_ONLY=<MCP_READ_ONLY> awesome-mineflayer-mcp npx -y awesome-mineflayer-mcp
```
Вместо <…> подставьте свои значения. Ещё 1 переменная окружения — в README сервера

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

## Примеры запросов агенту
- Подключись к `localhost` под ником `DevBot` с `auth: "offline"` и покажи`get_connection_status`
- Накопай десять блоков дуба рядом с ботом и положи в ближайший сундук
- Сделай скриншот от первого лица и скажи, что видно вокруг

## Похожие
- [REA](https://affpapa.org/nevibecode/mcp/rea.md) — MCP-сервер · ★ 392262
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33989
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81163
- [browser-use](https://affpapa.org/nevibecode/mcp/browser-use.md) — MCP-сервер · ★ 119231

_Часть страницы не вошла по размеру — она есть в HTML-версии._

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