Skip to main content
Glama
MC-World-MCP
by Asakitan

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, экспорт/размещение блоков с сущностями блоков и сущностями в меру возможностей

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers