Minecraft MCP Server for VS Code: Setup & Config

What you can do with Minecraft in VS Code

A focused Mineflayer-backed MCP bridge for hands-on assistant interaction with a Minecraft world.

• Direct an assistant-controlled character around a LAN world.
• Inspect inventory and equip items through natural-language requests.

Before you start: Minecraft in VS Code

• Git
• Node.js 20.10.0 or later
• A running compatible Minecraft game with a reachable world
• An MCP-compatible client

The README opens a single-player world to LAN and configures the bot's host and port to match. Its current support notice names Minecraft 1.21.11, while the setup walkthrough mentions testing Java Edition 1.21.8. Restart the desktop client fully after configuration. No required environment variables are stated.

Minecraft VS Code configuration

1. Choose VS Code configuration scope

   For Minecraft MCP Server, open Workspace: .vscode/mcp.json. Merge into servers; preserve existing inputs.

2. Add Minecraft MCP Server to VS Code

   Use the minecraft-mcp-server entry below in servers. Keep Minecraft MCP Server's documented stdio connection fields and your other VS Code entries.

3. Check Minecraft MCP Server in VS Code

   Minecraft MCP Server: Start in VS Code’s MCP controls; inspect output and trust prompts.

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

Minecraft tools available to VS Code

Minecraft's stored tool list documents 18 tools; compare it with VS Code's connected tool list, because the stored list is not a live check.

get-position

Look for get-position among VS Code's agent-mode tools after starting Minecraft through the MCP controls.

Read the bot's current coordinates.

move-to-position

Look for move-to-position among VS Code's agent-mode tools after starting Minecraft through the MCP controls.

Move the bot toward specified coordinates.

look-at

Look for look-at among VS Code's agent-mode tools after starting Minecraft through the MCP controls.

Aim the bot's view at a selected position.

jump

Look for jump among VS Code's agent-mode tools after starting Minecraft through the MCP controls.

Make the bot perform a jump.

move-in-direction

Look for move-in-direction among VS Code's agent-mode tools after starting Minecraft through the MCP controls.

Move in a chosen direction for a specified duration.

fly-to

Look for fly-to among VS Code's agent-mode tools after starting Minecraft through the MCP controls.

list-inventory

Look for list-inventory among VS Code's agent-mode tools after starting Minecraft through the MCP controls.

find-item

Look for find-item among VS Code's agent-mode tools after starting Minecraft through the MCP controls.

equip-item

Look for equip-item among VS Code's agent-mode tools after starting Minecraft through the MCP controls.

place-block

Look for place-block among VS Code's agent-mode tools after starting Minecraft through the MCP controls.

Place a block at a selected position.

dig-block

Look for dig-block among VS Code's agent-mode tools after starting Minecraft through the MCP controls.

Dig the block at a selected position.

get-block-info

Look for get-block-info among VS Code's agent-mode tools after starting Minecraft through the MCP controls.

Inspect information about a block.

find-blocks

Look for find-blocks among VS Code's agent-mode tools after starting Minecraft through the MCP controls.

Locate nearby blocks of a requested type.

smelt-item

Look for smelt-item among VS Code's agent-mode tools after starting Minecraft through the MCP controls.

find-entity

Look for find-entity among VS Code's agent-mode tools after starting Minecraft through the MCP controls.

send-chat

Look for send-chat among VS Code's agent-mode tools after starting Minecraft through the MCP controls.

read-chat

Look for read-chat among VS Code's agent-mode tools after starting Minecraft through the MCP controls.

detect-gamemode

Look for detect-gamemode among VS Code's agent-mode tools after starting Minecraft through the MCP controls.

Minecraft: full stored tool descriptions

Troubleshooting Minecraft in VS Code

• Make npx (Node.js/npm) available in the workspace, container, or remote environment hosting Minecraft MCP Server. Start through VS Code's MCP controls; inspect output and trust prompts.
• Minecraft MCP Server uses stdio here: VS Code must keep the configured process running; protocol output belongs on stdout and diagnostics on stderr.
• Known limitation: Requires a running game and a reachable world.
• Known limitation: The compatibility notice warns that versions newer than 1.21.11 may not work.
• Known limitation: Desktop client startup can take time.
• General VS Code troubleshooting lives in the /clients/vscode guide.

Frequently asked questions