Integración de Minecraft MCP

Una integración del Protocolo de Contexto de Modelo (MCP) para Minecraft permite a los asistentes de IA interactuar con un servidor de Minecraft. Esta integración permite a los modelos de IA observar e interactuar con el mundo de Minecraft a través de un bot.

Prerrequisitos

1. Lanzador de Minecraft

2. Node.js 18 o superior

3. Aplicación de escritorio Claude

4. Java 21.0.5 (recomendado)

⚠️ Nota: Actualmente solo se ha probado en macOS/Linux. No se garantiza la compatibilidad con Windows.

Related MCP server: OmniMCP

Nota importante

1. Usa el atajo F3+P : Presiona F3 + P simultáneamente. Esto activa la función "Pausar al perder el foco". Una vez desactivada, puedes cambiar al escritorio de Claude y Minecraft seguirá ejecutándose sin pausas.

2. Problemas de conexión al reiniciar Claude : Si reinicias Claude mientras el servidor de Minecraft está en ejecución, podrías experimentar problemas de conexión con MCP la próxima vez que inicies Claude debido a un proceso de Java persistente. Consulta Solución de problemas: Error de conexión con MCP para obtener información sobre cómo solucionarlo.

Pasos de instalación

1. Descargar y configurar el servidor de Minecraft

   • Descargue el servidor de Minecraft v1.21 desde mcversions.net/1.21

   • Instale Java 21.0.5 si aún no está instalado (las demás versiones no están probadas)

   • Crea un directorio dedicado (por ejemplo, ~/minecraft-server/ )

   • Coloque el archivo server.jar descargado en este directorio

   • Anota la ruta absoluta a tu archivo server.jar

2. Instalar y configurar la integración de MCP

   Instalación rápida (recomendada):

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

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

   O configuración manual:

   • Vaya a ~/Library/Application Support/Claude/claude_desktop_config.json

   • Agregue la configuración del servidor MCP:

   { "mcpServers": { "mcp-minecraft": { "command": "npx", "args": [ "-y", "mcp-minecraft@latest", "--server-jar", "/absolute/path/to/minecraft-server/server.jar" ] } } }

   ⚠️ Reemplace /absolute/path/to/minecraft-server/server.jar con su ruta server.jar real

3. Iniciar Claude Desktop

   • Inicie Claude Desktop después de completar la configuración

4. Conectarse al servidor

   • Abrir el lanzador de Minecraft

   • Instalar y ejecutar Minecraft Java Edition v1.21

   • Haz clic en "Jugar" y selecciona "Multijugador".

   • Haga clic en "Agregar servidor"

   • Introduzca los detalles del servidor:

     • Nombre del servidor: Minecraft Server

     • Dirección del servidor: localhost:25565

   • Haga clic en "Listo"

Características

Recursos

La integración expone estos recursos de MCP:

• minecraft://bot/location - Posición actual del bot en el mundo

• minecraft://bot/status - Estado de conexión del bot

Herramientas

Herramientas MCP disponibles:

• chat - Envía mensajes de chat al servidor

• jump - Hacer que el bot salte

• moveForward - Hacer que el bot avance

• moveBack - Hace que el bot se mueva hacia atrás

• turnLeft - Hace que el bot gire a la izquierda

• turnRight - Hace que el bot gire a la derecha

• placeBlock - Coloca un bloque en las coordenadas especificadas

• digBlock - Rompe un bloque en coordenadas específicas

• getBlockInfo : obtiene información sobre un bloque en coordenadas específicas

• selectSlot - Selecciona una ranura de la barra de acceso rápido (0-8)

• getInventory - Obtener el contenido del inventario del bot

• equipItem - Equipa un artículo por nombre a un destino específico

• getStatus : obtiene el estado actual del bot (salud, comida, posición, etc.)

• getNearbyEntities : obtiene una lista de entidades cercanas dentro del rango

• attack - Ataque a una entidad cercana por su nombre

• useItem - Usar/activar el elemento actualmente en uso

• stopUsingItem - Dejar de usar/desactivar el elemento actual

• lookAt - Hacer que el bot mire coordenadas específicas

• followPlayer - Sigue a un jugador específico

• stopFollowing - Dejar de seguir al objetivo actual

• goToPosition - Navegar a coordenadas específicas

Detalles técnicos

• El servidor se ejecuta en modo fuera de línea para el desarrollo local

• Asignación de memoria predeterminada: 2 GB

• Puerto predeterminado: 25565

• Nombre de usuario del bot: MCPBot

Solución de problemas

Problemas comunes

1. Error de conexión MCP

   • Busque procesos Java persistentes

   • Terminarlos manualmente:

     • Windows: usar el Administrador de tareas (no probado)

     • Mac/Linux:

       • Vaya a 'Monitor de actividad' y 'Forzar salida' de Java

   • Reiniciar la computadora si falla la finalización del proceso

   • Nota: La última versión debería resolver automáticamente estos problemas.

2. El servidor no se inicia

   • Verificar que Java esté instalado

   • Compruebe que la ruta del servidor.jar sea correcta

   • Asegúrese de que el puerto 25565 esté disponible

3. No se puede conectar al servidor

   • Verificar que el servidor esté en ejecución (verificar registros)

   • Confirme que está utilizando "localhost" como dirección del servidor

   • Comprobar la configuración del firewall

Ubicación de los registros

• Registros del servidor de Minecraft: comprobar el directorio minecraft-server

• Registros del escritorio de Claude: ~/Library/Logs/Claude/mcp*.log

Contribuyendo

¡Contribuciones grandes o pequeñas son bienvenidas!

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.