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