Control remoto MCP de Minecraft

Este proyecto está inspirado en mcp-minecraft de arjunkmrm. Si bien el proyecto original solo admitía conexiones locales a servidores de Minecraft, este proyecto se creó desde cero para añadir compatibilidad con servidores remotos de Minecraft.

Control remoto de Minecraft mediante MCP (Protocolo de contexto de modelo).

Características

• Conéctate y controla a un jugador de Minecraft a través de un asistente de IA
• Navega, extrae, construye e interactúa con el mundo de Minecraft.
• Chatea con otros jugadores en el servidor
• Consultar inventario, posición del jugador e información del servidor
• Control de movimiento avanzado que incluye saltos, sigilo y carreras de velocidad.
• Interacción de entidades que incluye ataques y seguimiento
• Uso de contenedores (arcos, hornos, etc.)
• Fabricación de objetos y comercio entre aldeanos
• Gestión detallada del inventario

Instalación

Instalación rápida (recomendada)

Siga las instrucciones de la CLI para completar la configuración.

Instalación manual

Uso

Uso con Claude Desktop

1. Vaya al archivo de configuración de Claude Desktop:
   • Ventanas: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json
2. Agregue la configuración de Minecraft Remote MCP a su archivo de configuración:

Si lo has instalado globalmente:

Si ha clonado el repositorio localmente:

3. Guarde el archivo y reinicie Claude Desktop
4. Inicia una nueva conversación con Claude y comienza a usar los comandos de control de Minecraft

Requisitos importantes del servidor

• Modo en línea del servidor : El servidor de Minecraft debe tener online-mode=false establecida en el archivo server.properties. Esto permite que el bot se conecte sin autenticación a los servidores de sesión de Minecraft.
• Si usa un servidor con autenticación, deberá proporcionar credenciales de cuenta premium válidas al conectarse.

Herramientas disponibles

Funcionalidad principal

• connectToServer : Conectarse a un servidor de Minecraft con las credenciales especificadas
• disconnectFromServer : Desconectarse del servidor de Minecraft
• sendChat : Envía un mensaje de chat al servidor
• getServerInfo : obtiene información sobre el servidor conectado

Movimiento

• getPosition : Obtener la posición actual del jugador
• moveTo : Mover a coordenadas específicas
• moveControl : Controles básicos de movimiento (adelante, atrás, izquierda, derecha, saltar, correr, sigiloso, detenerse)
• lookAt : hace que el jugador mire en una dirección específica o en coordenadas

Interacción mundial

• digBlock : Extrae un bloque en coordenadas específicas
• placeBlock : Coloca un bloque en coordenadas específicas

Gestión de inventario

• checkInventory : Comprobación básica de inventario
• inventoryDetails : Obtenga información detallada sobre los artículos del inventario
• equipItem : Equipa un objeto del inventario a la mano o a la ranura de armadura
• tossItem : Lanzar objetos del inventario

Interacción entre entidades

• getNearbyPlayers : Obtener lista de jugadores cercanos
• getNearbyEntities : Obtenga una lista de todas las entidades cercanas
• attackEntity : Ataque a una entidad específica
• useOnEntity : usar el elemento retenido en una entidad específica
• followEntity : Sigue una entidad específica

Interacción de contenedores

• openContainer : abre un contenedor (cofre, horno, etc.) en coordenadas específicas
• withdrawItem : Tomar artículos de un contenedor abierto
• depositItem : Colocar artículos en un contenedor abierto
• closeContainer : Cierra el contenedor actualmente abierto

Elaboración

• getRecipes : Obtén una lista de recetas de elaboración disponibles
• craftItem : Crea un objeto usando los materiales disponibles

Comercio

• listTrades : enumera los intercambios disponibles de un aldeano cercano
• tradeWithVillager : Intercambia con un aldeano cercano

Ejemplos de indicaciones

Controles básicos

• Conéctate al servidor de Minecraft en play.example.com con el nombre de usuario player1.
• "¿Cuál es mi posición actual en el juego?"
• "Muéveme a las coordenadas x=100, y=64, z=-200"
• "Hazme caminar hacia adelante durante 3 segundos"
• "Hazme saltar y correr hacia esa montaña"

Inventario y artículos

• "Consulta mi inventario en detalle"
• "Equipa mi espada de diamante en mi mano"
• "Lanza 5 bloques de tierra de mi inventario"

Interacción de bloques

• "Excave el bloque en las coordenadas x=10, y=65, z=20"
• "Coloca un bloque de piedra en las coordenadas x=11, y=65, z=20"

Interacción entre entidades

• "¿Hay otros jugadores cerca?"
• "¿Qué entidades se encuentran a 20 cuadras de mí?"
• Ataca al zombi con ID 12345
• "Sigue al jugador llamado Steve"

Uso de contenedores

• "Abre el cofre en las coordenadas x=100, y=64, z=200"
• "Toma 10 lingotes de hierro del cofre"
• "Pon 5 adoquines en el cofre"
• "Cerrar el contenedor"

Fabricación y comercio

• "¿Qué recetas tengo disponibles para un pico de madera?"
• "Fabrica 4 palos con la madera de mi inventario"
• "Consulta qué intercambios ofrece el aldeano cercano"
• "Comercia con el aldeano para conseguir 10 esmeraldas"

Comunicación

• "Envía un mensaje de saludo al chat"
• "Dile a todos que encontré diamantes"

Requisitos

• Node.js 18+
• Un asistente de IA que apoya a MCP (como Claude)
• Un servidor de Minecraft Java Edition (versión 1.8 o posterior)

Nota : Esta herramienta ha sido probada y verificada para funcionar específicamente con Minecraft 1.21. Si bien puede funcionar con otras versiones o servidores modificados, no se garantiza la compatibilidad.

Licencia

Instituto Tecnológico de Massachusetts (MIT)