Minecraft — MCP-сервер для Claude Code: функции и установка
MCP-сервер связывает ИИ-агента с Minecraft через WorldAPI: он читает данные мира и выполняет разрешённые действия. Подходит для проверки сервера и управления им из чата.
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Что делает Minecraft
Агент получает доступ к данным о игроках, мирах, блоках, сундуках, сущностях, рецептах, настройках и журналах. Среди доступных действий — запуск команд и Java-скриптов, чтение инвентарей, а также изменение конфигурации, если это разрешает токен. Сервер также может сообщать о событиях, например о входе игрока.
Для работы нужен WorldAPI на сервере Paper, Fabric или NeoForge; для одиночной игры требуется мод WorldAPI в игровом мире. MCP-сервер подключается к WorldAPI через Claude Code, Codex, Cursor и другие перечисленные MCP-клиенты. Права токена определяют, какие инструменты увидит агент: токен только для чтения скрывает операции записи, а токен зрителя открывает 17 инструментов для просмотра. Без настроенного WorldAPI подключаться не к чему.
Какие задачи решает
- узнать, кто сейчас в сети и где находится
- проверить состояние сервера и разобраться с задержками
- прочитать настройки и журналы сервера
- изменить разрешённое значение конфигурации, сохранив комментарии
- отслеживать вход игрока на сервер
Примеры запросов агенту
- Покажи, кто сейчас на сервере и где находятся игроки.
- Проверь журналы и выясни, из-за чего сервер тормозит.
- Сообщи мне, когда Steve зайдёт на сервер.
Как установить Minecraft
Командой платформы
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 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Вместо <…> подставьте свои значения
Файл настроек
{
"mcpServers": {
"minecraft": {
"command": "npx",
"args": [
"-y",
"@mairwunnx/minecraft-mcp"
],
"env": {
"WORLDAPI_URL": "<WORLDAPI_URL>",
"WORLDAPI_TOKEN": "<WORLDAPI_TOKEN>",
"WORLDAPI_READ_ONLY": "<WORLDAPI_READ_ONLY>"
}
}
}
}Вместо <…> подставьте свои значения
Файл настроек
{
"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 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Вместо <…> подставьте свои значения
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Minecraft
Как установить Minecraft в Claude Code?
Сначала выполните claude mcp add minecraft-mcp -e WORLDAPI_URL=<WORLDAPI_URL> -e WORLDAPI_TOKEN=<WORLDAPI_TOKEN> -- npx -y @mairwunnx/minecraft-mcp. Перед этим установите WorldAPI на сервер Paper, Fabric или NeoForge и создайте токен командой /worldapi token create agent.
Что делает Minecraft MCP-сервер?
Он даёт ИИ-агенту доступ к Minecraft через WorldAPI: агент может читать данные мира и выполнять действия, разрешённые токеном.
Что нужно для подключения к Minecraft?
Нужен WorldAPI на сервере Paper, Fabric или NeoForge и токен. Для одиночной игры установите мод WorldAPI в игровой мир.
