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

MC-World-MCP

Herramientas MCP exclusivamente offline para operar en un directorio de servidor de Minecraft.

Este MCP intencionalmente no utiliza RCON, sockets, consultas de jugadores online ni controles de inicio/parada del servidor. Solo lee y escribe archivos locales como level.dat, datapacks, plantillas de estructuras, registros y archivos de región Anvil.

La ruta de escritura completa está dirigida a mundos de Java Edition / Arclight 1.20.1 con DataVersion 3465. Otros mundos Java Anvil son detectados y expuestos para lecturas de mejor esfuerzo, pero las escrituras en el mundo son rechazadas a menos que el adaptador de versión los marque como totalmente compatibles. Los mundos Bedrock LevelDB son detectados como no compatibles.

Ejecución

Cuando este proyecto se encuentra en E:/VC/mc-world-mcp y un espacio de trabajo del servidor se encuentra dos niveles por debajo de E:/VC, el archivo .vscode/mcp.json del espacio de trabajo inicia el servidor con:

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

MC_SERVER_ROOT debe apuntar a la raíz del servidor Arclight que contiene server.properties y world/. Si se omite, el servidor intenta utilizar primero el directorio de trabajo actual.

La selección del mundo sigue el level-name de server.properties, por lo que un servidor que utiliza level-name=world_regen_source se opera a través de ese directorio en lugar de un world/ codificado. Establezca MC_WORLD_NAME para anular esto explícitamente.

Related MCP server: ellmos-filecommander-mcp

Seguridad

Todas las herramientas de escritura:

  • rechazan rutas fuera de MC_SERVER_ROOT

  • rechazan escrituras cuando un proceso java o javaw está en ejecución

  • rechazan escrituras en mundos Java a menos que el mundo seleccionado sea DataVersion 3465

  • realizan una copia de seguridad de cada archivo modificado en backup/mc_world_mcp/<timestamp>/

  • escriben un manifest.json que describe los archivos modificados

Las herramientas de lectura están permitidas mientras el servidor está en ejecución.

Grupos de herramientas

  • Servidor/archivos: resúmenes, lectura/escritura segura de archivos, registros, detección de versión/plataforma

  • NBT: level.dat, datos de jugador, datos del mundo, NBT de estructuras

  • Datapacks: listado de datapacks en carpetas y zip, validación, búsqueda, lectura, escritura

  • Regiones: escaneo, inspección de chunks, obtener/leer/establecer/rellenar/reemplazar bloques, cadenas de estado de bloque

  • Diagnóstico del mundo: dimensiones, cobertura del mundo, paletas de chunks, agrupación de problemas de registro

  • Datos del mundo: entidades de bloque, regiones de entidades externas, regiones POI, cajas de biomas, limpieza de mapas de altura, poda de chunks

  • Plantillas: listar/leer/escribir plantillas de estructura .nbt, exportar/colocar bloques con entidades de bloque y entidades de mejor esfuerzo

  • Seguridad: comprobaciones offline, listado de copias de seguridad, restauración de copias de seguridad

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