minecraft mcp for VS Code

io.github.makkch/minecraft-mcp

Control a Minecraft client with the Minecraft MCP mod and JsMacros Reloaded.

client:VS Code transport:stdio runtime:npm

Install minecraft mcp in VS Code

.vscode/mcp.json

{
  "inputs": [
    {
      "type": "promptString",
      "id": "minecraft-mcp-token",
      "description": "MINECRAFT_MCP_TOKEN",
      "password": true
    },
    {
      "type": "promptString",
      "id": "minecraft-mcp-port",
      "description": "MINECRAFT_MCP_PORT",
      "password": true
    },
    {
      "type": "promptString",
      "id": "minecraft-mcp-url",
      "description": "MINECRAFT_MCP_URL",
      "password": true
    }
  ],
  "servers": {
    "minecraft-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@makkch/minecraft-mcp"
      ],
      "env": {
        "MINECRAFT_MCP_TOKEN": "${input:minecraft-mcp-token}",
        "MINECRAFT_MCP_PORT": "${input:minecraft-mcp-port}",
        "MINECRAFT_MCP_URL": "${input:minecraft-mcp-url}"
      }
    }
  }
}

VS Code prompts for each input the first time the server starts, so no secret is written to the file. VS Code docs

minecraft mcp in other clients

minecraft mcp MCP server