Awesome Mineflayer MCP — MCP-сервер для Claude Code: бот в Minecraft
Даёт агенту управление ботом Mineflayer: ходить, копать, крафтить, драться, строить. Ставится в Claude, Cursor, Codex и другие MCP-клиенты.
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Что делает 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: без него бот пойдёт на любой адрес.
Какие задачи решает
- поднять бота в Minecraft и ходить им по координатам
- накопать ресурсов и разложить добычу по сундукам
- собрать крафт из предметов в инвентаре
- посмотреть глазами бота через скриншот и карту
- задать маршрут по меткам и повторить постройку макросом
Примеры запросов агенту
- Подключись к
localhostпод никомDevBotсauth: "offline"и покажиget_connection_status - Накопай десять блоков дуба рядом с ботом и положи в ближайший сундук
- Сделай скриншот от первого лица и скажи, что видно вокруг
Как установить Awesome Mineflayer MCP
Командой платформы
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 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 сервера
Файл настроек
{
"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 сервера
Файл настроек
{
"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 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 сервера
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Awesome Mineflayer MCP
Как установить Awesome Mineflayer MCP в Claude Code?
Базово: claude mcp add awesome-mineflayer-mcp -- npx -y awesome-mineflayer-mcp. Если нужны переменные окружения, добавь их через --env, например MCP_DEFAULT_HOST, MCP_DEFAULT_USERNAME, MCP_DEFAULT_AUTH, и укажи --transport stdio.
Что делает Awesome Mineflayer MCP?
Это MCP-сервер поверх Mineflayer. Он даёт агенту инструменты, чтобы вести бота в Minecraft: двигаться, копать, крафтить, драться, открывать контейнеры и общаться в чате.
Что нужно для работы?
Node.js 20 или новее и сервер Minecraft Java Edition. Для online-mode сервера нужен аккаунт Microsoft, для offline-mode хватит ника.
