mcp-minecraft

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.

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 MCPInstalació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.