Servidor MCP de Minecraft

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

Un bot de Minecraft impulsado por modelos de lenguaje de gran tamaño y la API de Mineflayer. Este bot utiliza el Protocolo de Contexto de Modelo (MCP) para permitir que Claude y otros modelos compatibles controlen a un personaje de Minecraft.

Requisitos previos

• Git

• Node.js (>= 20.10.0)

• Un juego de Minecraft en ejecución (la configuración a continuación se probó con Minecraft 1.21.8 Java Edition incluido en Microsoft Game Pass)

• Un cliente compatible con MCP. Se utilizará Claude Desktop como ejemplo, pero también se admiten otros clientes MCP

Related MCP server: MCP Server

Primeros pasos

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

Ejecutar Minecraft

Crea un mundo de un solo jugador y ábrelo para LAN (ESC -> Abrir en 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 el siguiente paso.

Configuración de MCP

Asegúrate de que Claude Desktop esté instalado. Abre Archivo -> Configuración -> Desarrollador -> Editar configuración. Debería abrir el directorio de instalación. Busca el archivo con el nombre claude_desktop_config.json e inserta el siguiente código:

{
  "mcpServers": {
    "minecraft": {
      "command": "npx",
      "args": [
        "-y",
        "github:yuniko-software/minecraft-mcp-server",
        "--host",
        "localhost",
        "--port",
        "25565",
        "--username",
        "ClaudeBot"
      ]
    }
  }
}

Verifica dos veces que se hayan utilizado los parámetros --port y --host correctos. Asegúrate de reiniciar completamente la aplicación Claude Desktop (debe cerrarse en la bandeja del sistema).

Ejecución

Asegúrate de que el juego Minecraft esté ejecutándose y que el mundo esté abierto para LAN. Luego, inicia la aplicación Claude Desktop y el bot debería unirse al juego.

Puede tomar algo de tiempo para que Claude Desktop inicie el servidor MCP. El indicador de que el servidor se ha iniciado correctamente es:

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

No olvides mencionar en tu prompt que el bot debe hacer algo en Minecraft. Porque decir esto es un disparador para ejecutar el servidor MCP. Te pedirá tus permisos.

Usar Claude Sonnet podría darte resultados interesantes. El bot-agente será realmente 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 - Moverse a coordenadas específicas

• look-at - Hacer que el bot mire a 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 - Hacer que el bot vuele directamente a coordenadas específicas

Inventario

• list-inventory - Listar todos los objetos en el inventario del bot

• find-item - Encontrar un objeto específico en el inventario

• equip-item - Equipar un objeto específico

Interacción con bloques

• place-block - Colocar un bloque en las coordenadas especificadas

• dig-block - Cavar un bloque en las coordenadas especificadas

• get-block-info - Obtener información sobre un bloque

• find-blocks - Encontrar uno o más bloques cercanos de un tipo específico

Horno

• smelt-item - Fundir objetos usando un bloque tipo horno

Interacción con entidades

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

Comunicación

• send-chat - Enviar un mensaje de chat en el juego

• read-chat - Obtener mensajes de chat recientes de los jugadores

Estado del juego

• detect-gamemode - Detectar el modo de juego en la partida

Contribución

Siéntete libre de enviar solicitudes de extracción (pull requests) o abrir problemas (issues) para mejoras. ¡Todos los commits de refactorización, contribuciones funcionales y de prueba, problemas y discusiones son muy apreciados!

Para comenzar a contribuir, consulta CONTRIBUTING.md.

⭐ Si encuentras útil este proyecto, ¡considera darle una estrella en GitHub! ⭐

Tu apoyo ayuda a hacer que este proyecto sea más visible para otras personas que podrían beneficiarse de él.