minecraft-mcp — MCP-сервер для Minecraft: что делает и как установить
MCP-сервер для Claude Code, позволяющий ИИ-агенту управлять персонажем в Minecraft. Агент выполняет JavaScript-сценарии через JsMacros, делает снимки экрана и общается в игровом чате.
MIT ★ 26 обновлён 2026-11-13
claude mcp add --env MINECRAFT_MCP_TOKEN=<MINECRAFT_MCP_TOKEN> --env MINECRAFT_MCP_PORT=<MINECRAFT_MCP_PORT> --env MINECRAFT_MCP_URL=<MINECRAFT_MCP_URL> --transport stdio minecraft-mcp -- npx -y @makkch/minecraft-mcpЧто делает minecraft-mcp
Этот сервер превращает игру в набор инструментов, доступных для управления через среду ИИ. Для начала работы установите модификацию Fabric в папку mods/ вместе с JsMacros и Baritone, получите токен и порт в настройках мода, нажав F8 в игре.
Система работает через создание, запуск и чтение вывода JavaScript-скриптов. В любой момент управление можно вернуть себе, написав в чат /mcp stop. Для полноценной работы потребуются Fabric Loader версии 0.19.5 или выше и установленная Java 25 или новее.
Какие задачи решает
- автоматизировать добычу ресурсов в Minecraft
- строить архитектурные объекты по заданию агента
- проходить игровые квесты без ручного участия
Примеры запросов агенту
- «Построй небольшую хижину из дуба на берегу реки»
- «Найди ближайшую деревню и собери там урожай»
- «Добудь железо для создания новой кирки»
Как установить minecraft-mcp
Командой платформы
claude mcp add --env MINECRAFT_MCP_TOKEN=<MINECRAFT_MCP_TOKEN> --env MINECRAFT_MCP_PORT=<MINECRAFT_MCP_PORT> --env MINECRAFT_MCP_URL=<MINECRAFT_MCP_URL> --transport stdio minecraft-mcp -- npx -y @makkch/minecraft-mcpВместо <…> подставьте свои значения
Командой платформы
codex mcp add minecraft-mcp --env MINECRAFT_MCP_TOKEN=<MINECRAFT_MCP_TOKEN> --env MINECRAFT_MCP_PORT=<MINECRAFT_MCP_PORT> --env MINECRAFT_MCP_URL=<MINECRAFT_MCP_URL> -- npx -y @makkch/minecraft-mcpВместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"minecraft-mcp": {
"command": "npx",
"args": [
"-y",
"@makkch/minecraft-mcp"
],
"env": {
"MINECRAFT_MCP_TOKEN": "<MINECRAFT_MCP_TOKEN>",
"MINECRAFT_MCP_PORT": "<MINECRAFT_MCP_PORT>",
"MINECRAFT_MCP_URL": "<MINECRAFT_MCP_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"servers": {
"minecraft-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@makkch/minecraft-mcp"
],
"env": {
"MINECRAFT_MCP_TOKEN": "<MINECRAFT_MCP_TOKEN>",
"MINECRAFT_MCP_PORT": "<MINECRAFT_MCP_PORT>",
"MINECRAFT_MCP_URL": "<MINECRAFT_MCP_URL>"
}
}
}
}Вместо <…> подставьте свои значения
Командой платформы
gemini mcp add -e MINECRAFT_MCP_TOKEN=<MINECRAFT_MCP_TOKEN> -e MINECRAFT_MCP_PORT=<MINECRAFT_MCP_PORT> -e MINECRAFT_MCP_URL=<MINECRAFT_MCP_URL> minecraft-mcp npx -y @makkch/minecraft-mcpВместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о minecraft-mcp
Как установить minecraft-mcp?
Скачайте нужный JAR-файл с GitHub, поместите его в папку mods/ игры, запустите Minecraft и скопируйте токен из меню настроек по клавише F8. Затем добавьте MCP-сервер в конфигурацию агента, указав полученный токен и стандартный порт 28473.
Что делает minecraft-mcp?
Он предоставляет ИИ-агенту доступ к игровым действиям через выполнение JavaScript-скриптов, позволяя ему перемещаться, добывать ресурсы, строить и взаимодействовать с миром игры.
Что нужно для работы minecraft-mcp?
Для работы необходима игра Minecraft Java Edition на движке Fabric, установленные JsMacros Reloaded, Java 25 или новее и Node.js версии 22 или выше для запуска сервера.