HeadlessMc — MCP-сервер для Claude Code: установка
MCP-сервер управляет Minecraft: Java Edition из ИИ-агента: устанавливает версии и моды, запускает клиенты и серверы, читает экран и логи.
claude mcp add headlessmc-mcp -- npx -y @headlesshq/headlessmc-mcpЧто делает HeadlessMc
HeadlessMc подключает Minecraft: Java Edition к MCP-клиенту. Агент может установить vanilla, Fabric, Forge или NeoForge, добавить моды из Modrinth, запустить несколько клиентов и серверов, подключиться к серверу, отправить чат или команду и прочитать логи.
Внутри есть инструменты для профилей, экземпляров, экранов и состояния игры. launch_client ждёт главное меню, start_server — загрузки мира; отдельные вызовы позволяют нажимать кнопки, вводить текст, ждать события и выполнять команды на сервере. Режим без дисплея и GPU подходит для CI или Docker.
Для управления игрой сервер добавляет HMC-Specifics и мод hmc-mcp-bridge. Без отдельного профиля несколько клиентов одной версии могут использовать один каталог игры, поэтому их запускают с разными профилями. Управление поддерживает версии Minecraft от 1.7.10 до 26.x и загрузчики Forge, Fabric и NeoForge.
Какие задачи решает
- установить версию Minecraft и загрузчик
- запустить несколько клиентов в отдельных профилях
- управлять экраном и чатом из агента
- прочитать логи и отправить команду серверу
- провести запуск клиента без дисплея в CI
Примеры запросов агенту
- Установи Fabric 1.21.5 и запусти клиент без графического интерфейса.
- Создай отдельный профиль, запусти Paper-сервер и дождись загрузки мира.
- Покажи текущий экран клиента, затем отправь сообщение в чат.
Как установить HeadlessMc
Командой платформы
claude mcp add headlessmc-mcp -- npx -y @headlesshq/headlessmc-mcpКомандой платформы
codex mcp add headlessmc -- npx -y @headlesshq/headlessmc-mcpФайл настроек
{
"mcpServers": {
"headlessmc": {
"command": "npx",
"args": [
"-y",
"@headlesshq/headlessmc-mcp"
]
}
}
}Файл настроек
{
"servers": {
"headlessmc": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@headlesshq/headlessmc-mcp"
]
}
}
}Командой платформы
gemini mcp add headlessmc npx -y @headlesshq/headlessmc-mcpПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о HeadlessMc
Как установить HeadlessMc в Claude Code?
Выполните claude mcp add headlessmc-mcp -- npx -y @headlesshq/headlessmc-mcp.
Что делает HeadlessMc?
Он даёт агенту инструменты для установки и запуска Minecraft: Java Edition, управления клиентами и серверами, чтения экранов и логов.
Какие версии Minecraft поддерживает управление игрой?
Управление работает с версиями от 1.7.10 до 26.x и с Forge, Fabric и NeoForge через HMC-Specifics.
