mcp-minecraft

Servidor MCP de Minecraft

⚠️ ADVERTENCIA IMPORTANTE DE COMPATIBILIDAD : Minecraft 1.21.5 se lanzó el 25 de marzo de 2025. Este bot NO es compatible con Minecraft 1.21.5. Usa Minecraft 1.21.4 hasta que lancemos una actualización compatible con la versión 1.21.5.

https://github.com/user-attachments/assets/6f17f329-3991-4bc7-badd-7cde9aacb92f

Un bot de Minecraft basado en grandes modelos de lenguaje y la API de Mineflayer . Este bot utiliza el Protocolo de Contexto de Modelo (MCP) para que Claude y otros modelos compatibles puedan controlar un personaje de Minecraft.

Prerrequisitos

• Git
• Node.js
• Un juego de Minecraft en ejecución (la configuración a continuación se probó con Minecraft 1.21.4 Java Edition incluido en Microsoft Game Pass)
• Escritorio de Claude

Empezando

Este bot está diseñado para ser utilizado con Claude Desktop a través del Protocolo de Contexto de Modelo (MCP).

Ejecutar Minecraft

Crea un mundo para un jugador y ábrelo en LAN ( ESC -> Open to LAN ). El bot intentará conectarse usando el puerto 25565 y el nombre de host localhost . Estos parámetros se pueden configurar en claude_desktop_config.json en un siguiente paso.

Configuración de MCP

Asegúrese de que Claude Desktop esté instalado. Abra File -> Settings -> Developer -> Edit Config . Debería abrir el directorio de instalación. Busque el archivo llamado claude_desktop_config.json e inserte el siguiente código:

Verifique que se hayan usado los parámetros --port y --host correctos. Asegúrese de reiniciar completamente la aplicación Claude Desktop (debe estar cerrada en la bandeja del sistema operativo).

Correr

Asegúrate de que el juego de Minecraft esté en ejecución y que el mundo esté conectado a la red local. Luego, inicia la aplicación Claude Desktop y el bot debería unirse al juego.

Claude Desktop podría tardar un tiempo en iniciar el servidor MCP. El icono de un martillo junto al chat indica que el servidor se ha iniciado correctamente.

Puedes darle órdenes al bot a través de cualquier chat activo de Claude Desktop. También puedes subir imágenes de edificios y pedirle que los construya. 😁

No olvides mencionar en tu mensaje que el bot debería hacer algo en Minecraft. Esto activa el servidor MCP y te solicitará permisos.

Usar Claude 3.7 Sonnet podría darte resultados interesantes. El agente-bot sería muy inteligente.

Ejemplo de uso: chat compartido de Claude

Comandos disponibles

Una vez conectado a un servidor de Minecraft, Claude puede usar estos comandos:

Movimiento

• get-position - Obtener la posición actual del bot
• move-to-position - Mover a coordenadas específicas
• look-at - Hacer que el bot mire coordenadas específicas
• jump - Hacer que el bot salte
• move-in-direction - Moverse en una dirección específica durante un tiempo

Vuelo

• fly-to - Hace que el bot vuele directamente a coordenadas específicas

Inventario

• list-inventory : enumera todos los elementos en el inventario del bot
• find-item - Encuentra un artículo específico en el inventario
• equip-item - Equipar un objeto específico

Interacción de bloques

• place-block - Coloca un bloque en coordenadas específicas
• dig-block - Excavar un bloque en coordenadas específicas
• get-block-info - Obtener información sobre un bloque
• find-block - Encuentra el bloque más cercano de un tipo específico

Interacción entre entidades

• find-entity - Encuentra la entidad más cercana de un tipo específico

Comunicación

• send-chat - Envía un mensaje de chat en el juego

Contribuyendo

Esta aplicación se creó en tan solo dos días y el código es realmente simple y directo. ¡Agradecemos enormemente todas las confirmaciones de refactorización, las contribuciones funcionales y de prueba, los problemas y las discusiones!

No dudes en enviar solicitudes de incorporación de cambios o abrir incidencias para mejorarlas. Algunas áreas que podrían mejorarse:

• Documentación adicional
• Manejo de errores más robusto
• Pruebas para diferentes componentes
• Nuevas funcionalidades y comandos