MCP Minecraft Remote

Controlar

GitHub
13
Prueba este MCPPatrocinado

Documentación

smithery badge MseeP.ai Security Assessment Badge

MCP Minecraft Remote

Este proyecto está inspirado en mcp-minecraft de arjunkmrm. Mientras que el original solo admitía conexiones a servidores locales de Minecraft, este proyecto fue creado desde cero para agregar soporte para conectarse a servidores remotos de Minecraft.

Control remoto de Minecraft usando MCP (Model Context Protocol).

Características

  • Conéctate y controla un jugador de Minecraft mediante un asistente de IA
  • Navega, mina, construye e interactúa con el mundo de Minecraft
  • Chatea con otros jugadores en el servidor
  • Consulta inventario, posición del jugador e información del servidor
  • Control avanzado de movimiento, incluyendo saltar, agacharse y esprintar
  • Interacción con entidades, incluyendo atacar y seguir
  • Uso de contenedores (cofres, hornos, etc.)
  • Fabricación de objetos e intercambio con aldeanos
  • Gestión detallada del inventario

Instalación

Instalación mediante Smithery

Para instalar Minecraft Remote Control para Claude Desktop automáticamente mediante Smithery:

npx -y @smithery/cli install @nacal/mcp-minecraft-remote --client claude

Instalación rápida (recomendada)

npx -y @smithery/cli install mcp-minecraft-remote --client claude

Sigue las indicaciones de la CLI para completar la configuración.

Instalación manual

# Install from npm
npm install -g mcp-minecraft-remote

# Or clone the repository
git clone https://github.com/nacal/mcp-minecraft-remote.git
cd mcp-minecraft-remote

# Install dependencies
npm install

# Build the project
npm run build

Uso

Uso con Claude Desktop

  1. Navega al archivo de configuración de Claude Desktop:

    • Windows: %APPDATA%\Claude\claude_desktop_config.json
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Linux: ~/.config/Claude/claude_desktop_config.json

  2. Agrega la configuración de MCP de Minecraft Remote a tu archivo de configuración:

{
  "mcpServers": {
    "minecraft-remote": {
      "command": "npx",
      "args": ["-y", "mcp-minecraft-remote@latest"]
    }
  }
}

Si lo has instalado globalmente:

{
  "mcpServers": {
    "minecraft-remote": {
      "command": "mcp-minecraft-remote"
    }
  }
}

Si has clonado el repositorio localmente:

{
  "mcpServers": {
    "minecraft-remote": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-minecraft-remote/build/index.js"]
    }
  }
}
  1. Guarda el archivo y reinicia Claude Desktop
  2. 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 configurado en el archivo server.properties. Esto permite que el bot se conecte sin autenticación contra los servidores de sesión de Minecraft.
  • Si usas un servidor con autenticación, deberás proporcionar credenciales válidas de una cuenta premium al conectarte.

Herramientas disponibles

Funcionalidad principal

  • connectToServer: Conéctate a un servidor de Minecraft con las credenciales especificadas
  • disconnectFromServer: Desconéctate del servidor de Minecraft
  • sendChat: Envía un mensaje de chat al servidor
  • getServerInfo: Obtén información sobre el servidor conectado

Movimiento

  • getPosition: Obtén la posición actual del jugador
  • moveTo: Muévete a coordenadas específicas
  • moveControl: Controles básicos de movimiento (adelante, atrás, izquierda, derecha, saltar, esprintar, agacharse, detenerse)
  • lookAt: Haz que el jugador mire en una dirección específica o hacia coordenadas

Interacción con el mundo

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

Gestión del inventario

  • checkInventory: Verificación básica del inventario
  • inventoryDetails: Obtén información detallada sobre los objetos del inventario
  • equipItem: Equipa un objeto del inventario en la mano o en la ranura de armadura
  • tossItem: Lanza objetos desde el inventario

Interacción con entidades

  • getNearbyPlayers: Obtén la lista de jugadores cercanos
  • getNearbyEntities: Obtén una lista de todas las entidades cercanas
  • attackEntity: Ataca a una entidad específica
  • useOnEntity: Usa el objeto sostenido sobre una entidad específica
  • followEntity: Sigue a una entidad específica

Interacción con contenedores

  • openContainer: Abre un contenedor (cofre, horno, etc.) en coordenadas específicas
  • withdrawItem: Toma objetos de un contenedor abierto
  • depositItem: Coloca objetos en un contenedor abierto
  • closeContainer: Cierra el contenedor actualmente abierto

Fabricación

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

Intercambio

  • listTrades: Lista 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"
  • "Haz que camine hacia adelante durante 3 segundos"
  • "Haz que salte y esprinta hacia esa montaña"

Inventario y objetos

  • "Revisa qué hay en mi inventario en detalle"
  • "Equipa mi espada de diamante en mi mano"
  • "Lanza 5 bloques de tierra desde mi inventario"

Interacción con bloques

  • "Excava 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 con entidades

  • "¿Hay otros jugadores cerca?"
  • "¿Qué entidades están a menos de 20 bloques 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"
  • "Coloca 5 bloques de roca en el cofre"
  • "Cierra el contenedor"

Fabricación e intercambio

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

Comunicación

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

Requisitos

  • Node.js 18+
  • Un asistente de IA que admita 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 vanilla 1.21. Aunque puede funcionar con otras versiones o servidores modificados, no se garantiza la compatibilidad.

Licencia

MIT