MCP Minecraft Remote

Controle remotamente um servidor Minecraft Java Edition usando o Model Context Protocol (MCP).

GitHub
13
Experimente este MCPPatrocinado

Documentação

smithery badge MseeP.ai Security Assessment Badge

MCP Minecraft Remote

Este projeto é inspirado em mcp-minecraft por arjunkmrm. Enquanto o original suportava apenas conexões locais a servidores Minecraft, este projeto foi criado do zero para adicionar suporte à conexão com servidores Minecraft remotos.

Controle remoto do Minecraft usando MCP (Model Context Protocol).

Recursos

  • Conecte-se e controle um jogador do Minecraft por meio de um assistente de IA
  • Navegue, minere, construa e interaja com o mundo do Minecraft
  • Converse com outros jogadores no servidor
  • Verifique inventário, posição do jogador e informações do servidor
  • Controle avançado de movimento, incluindo pular, agachar e correr
  • Interação com entidades, incluindo atacar e seguir
  • Uso de contêineres (baús, fornalhas, etc.)
  • Criação de itens e negociação com aldeões
  • Gerenciamento detalhado de inventário

Instalação

Instalando via Smithery

Para instalar o Minecraft Remote Control para Claude Desktop automaticamente via Smithery:

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

Instalação Rápida (Recomendado)

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

Siga os prompts da CLI para concluir a configuração.

Instalação 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

Usando com Claude Desktop

  1. Navegue até o arquivo de configuração do 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. Adicione a configuração do MCP Minecraft Remote ao seu arquivo de configuração:

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

Se você o instalou globalmente:

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

Se você clonou o repositório localmente:

{
  "mcpServers": {
    "minecraft-remote": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-minecraft-remote/build/index.js"]
    }
  }
}
  1. Salve o arquivo e reinicie o Claude Desktop
  2. Inicie uma nova conversa com o Claude e comece a usar os comandos de controle do Minecraft

Requisitos Importantes do Servidor

  • Modo Online do Servidor: O servidor Minecraft deve ter online-mode=false definido no arquivo server.properties. Isso permite que o bot se conecte sem autenticação contra os servidores de sessão do Minecraft.
  • Se estiver usando um servidor com autenticação, você precisará fornecer credenciais válidas de conta premium ao conectar.

Ferramentas Disponíveis

Funcionalidade Principal

  • connectToServer: Conecte-se a um servidor Minecraft com as credenciais especificadas
  • disconnectFromServer: Desconecte-se do servidor Minecraft
  • sendChat: Envie uma mensagem de chat para o servidor
  • getServerInfo: Obtenha informações sobre o servidor conectado

Movimento

  • getPosition: Obtenha a posição atual do jogador
  • moveTo: Mova-se para coordenadas específicas
  • moveControl: Controles básicos de movimento (frente, trás, esquerda, direita, pular, correr, agachar, parar)
  • lookAt: Faça o jogador olhar em uma direção específica ou para coordenadas

Interação com o Mundo

  • digBlock: Minere um bloco em coordenadas específicas
  • placeBlock: Coloque um bloco em coordenadas específicas

Gerenciamento de Inventário

  • checkInventory: Verificação básica de inventário
  • inventoryDetails: Obtenha informações detalhadas sobre os itens do inventário
  • equipItem: Equipe um item do inventário na mão ou na armadura
  • tossItem: Jogue itens fora do inventário

Interação com Entidades

  • getNearbyPlayers: Obtenha a lista de jogadores próximos
  • getNearbyEntities: Obtenha uma lista de todas as entidades próximas
  • attackEntity: Ataque uma entidade específica
  • useOnEntity: Use o item segurado em uma entidade específica
  • followEntity: Siga uma entidade específica

Interação com Contêineres

  • openContainer: Abra um contêiner (baú, fornalha, etc.) em coordenadas específicas
  • withdrawItem: Pegue itens de um contêiner aberto
  • depositItem: Coloque itens em um contêiner aberto
  • closeContainer: Feche o contêiner atualmente aberto

Criação de Itens

  • getRecipes: Obtenha uma lista de receitas de criação disponíveis
  • craftItem: Crie um item usando os materiais disponíveis

Negociação

  • listTrades: Liste as negociações disponíveis de um aldeão próximo
  • tradeWithVillager: Negocie com um aldeão próximo

Exemplos de Prompts

Controles Básicos

  • "Conecte-se ao servidor Minecraft em play.example.com com o nome de usuário player1"
  • "Qual é a minha posição atual no jogo?"
  • "Mova-me para as coordenadas x=100, y=64, z=-200"
  • "Faça-me andar para frente por 3 segundos"
  • "Faça-me pular e correr em direção àquela montanha"

Inventário e Itens

  • "Verifique o que há no meu inventário em detalhes"
  • "Equipe minha espada de diamante na minha mão"
  • "Jogue 5 blocos de terra do meu inventário"

Interação com Blocos

  • "Cave o bloco nas coordenadas x=10, y=65, z=20"
  • "Coloque um bloco de pedra nas coordenadas x=11, y=65, z=20"

Interação com Entidades

  • "Há outros jogadores por perto?"
  • "Quais entidades estão a 20 blocos de mim?"
  • "Ataque o zumbi com ID 12345"
  • "Siga o jogador chamado Steve"

Uso de Contêineres

  • "Abra o baú nas coordenadas x=100, y=64, z=200"
  • "Pegue 10 barras de ferro do baú"
  • "Coloque 5 pedregulhos no baú"
  • "Feche o contêiner"

Criação e Negociação

  • "Quais receitas tenho disponíveis para uma picareta de madeira?"
  • "Crie 4 gravetos usando a madeira do meu inventário"
  • "Verifique quais negociações o aldeão próximo oferece"
  • "Negocie com o aldeão para obter 10 esmeraldas"

Comunicação

  • "Envie uma mensagem de olá para o chat"
  • "Diga a todos que encontrei diamantes"

Requisitos

  • Node.js 18+
  • Um assistente de IA que suporte MCP (como Claude)
  • Um servidor Minecraft Java Edition (versão 1.8 ou posterior)

Nota: Esta ferramenta foi testada e verificada para funcionar especificamente com Minecraft vanilla 1.21. Embora possa funcionar com outras versões ou servidores modificados, a compatibilidade não é garantida.

Licença

MIT