MC-World-MCP

Автономные инструменты MCP для работы с директорией сервера Minecraft.

Этот MCP намеренно не использует RCON, сокеты, запросы к игрокам онлайн или элементы управления запуском/остановкой сервера. Он только читает и записывает локальные файлы, такие как level.dat, датапаки, шаблоны структур, логи и файлы регионов Anvil.

Полный путь записи предназначен для миров Java Edition / Arclight 1.20.1 с DataVersion 3465. Другие миры Java Anvil обнаруживаются и предоставляются для чтения в меру возможностей, но запись в миры отклоняется, если адаптер версии не помечает их как полностью поддерживаемые. Миры Bedrock LevelDB определяются как неподдерживаемые.

Запуск

Когда этот проект находится в E:/VC/mc-world-mcp, а рабочая область сервера — на два уровня ниже E:/VC, файл .vscode/mcp.json рабочей области запускает сервер с помощью:

{
  "command": "python",
  "args": ["-m", "mc_world_mcp.server"],
  "env": {
    "PYTHONPATH": "${workspaceFolder}/../../mc-world-mcp/src",
    "MC_SERVER_ROOT": "${workspaceFolder}"
  }
}

MC_SERVER_ROOT должен указывать на корень сервера Arclight, который содержит server.properties и world/. Если он опущен, сервер сначала пытается использовать текущую рабочую директорию.

Выбор мира следует параметру level-name в server.properties, поэтому сервер, использующий level-name=world_regen_source, управляется через эту директорию, а не через жестко заданную world/. Установите MC_WORLD_NAME, чтобы переопределить это явно.

Related MCP server: ellmos-filecommander-mcp

Безопасность

Все инструменты записи:

• отклоняют пути вне MC_SERVER_ROOT

• отклоняют запись, если запущен процесс java или javaw

• отклоняют запись в миры Java, если выбранный мир имеет версию, отличную от DataVersion 3465

• создают резервную копию каждого измененного файла в backup/mc_world_mcp/<timestamp>/

• записывают manifest.json с описанием измененных файлов

Инструменты чтения разрешены во время работы сервера.

Группы инструментов

• Сервер/файлы: сводки, безопасное чтение/запись файлов, логи, определение версии/платформы

• NBT: level.dat, данные игрока, данные мира, NBT структур

• Датапаки: список датапаков в папках и zip-архивах, проверка, поиск, чтение, запись

• Регионы: сканирование, проверка чанков, получение/чтение/установка/заполнение/замена блоков, строки состояния блоков

• Диагностика мира: измерения, покрытие мира, палитры чанков, группировка проблем в логах

• Данные мира: сущности блоков, внешние регионы сущностей, регионы POI, биомные боксы, очистка карт высот, обрезка чанков

• Шаблоны: список/чтение/запись шаблонов структур .nbt, экспорт/размещение блоков с сущностями блоков и сущностями в меру возможностей

• Безопасность: автономные проверки, список резервных копий, восстановление из резервной копии