Minecraft MCP Server

Instructions

Implementation Reference

• src/bot.ts:414-435 (handler)

  The main handler function for the 'dig-block' tool. It resolves the block position, checks if diggable, moves if necessary, and calls bot.dig(block) to dig it.

  async ({ x, y, z }): Promise<McpResponse> => {
    try {
      const blockPos = new Vec3(x, y, z);
      const block = bot.blockAt(blockPos);
  
      if (!block || block.name === 'air') {
        return createResponse(`No block found at position (${x}, ${y}, ${z})`);
      }
  
      if (!bot.canDigBlock(block) || !bot.canSeeBlock(block)) {
        // Try to move closer to dig the block
        const goal = new goals.GoalNear(x, y, z, 2);
        await bot.pathfinder.goto(goal);
      }
  
      await bot.dig(block);
  
      return createResponse(`Dug ${block.name} at (${x}, ${y}, ${z})`);
    } catch (error) {
      return createErrorResponse(error as Error);
    }
  }

• src/bot.ts:409-413 (schema)

  Zod schema defining the input parameters: x, y, z coordinates as numbers.

  {
    x: z.number().describe("X coordinate"),
    y: z.number().describe("Y coordinate"),
    z: z.number().describe("Z coordinate"),
  },

• src/bot.ts:406-436 (registration)

  The server.tool() call that registers the 'dig-block' tool with its name, description, schema, and handler function.

  server.tool(
    "dig-block",
    "Dig a block at the specified position",
    {
      x: z.number().describe("X coordinate"),
      y: z.number().describe("Y coordinate"),
      z: z.number().describe("Z coordinate"),
    },
    async ({ x, y, z }): Promise<McpResponse> => {
      try {
        const blockPos = new Vec3(x, y, z);
        const block = bot.blockAt(blockPos);
  
        if (!block || block.name === 'air') {
          return createResponse(`No block found at position (${x}, ${y}, ${z})`);
        }
  
        if (!bot.canDigBlock(block) || !bot.canSeeBlock(block)) {
          // Try to move closer to dig the block
          const goal = new goals.GoalNear(x, y, z, 2);
          await bot.pathfinder.goto(goal);
        }
  
        await bot.dig(block);
  
        return createResponse(`Dug ${block.name} at (${x}, ${y}, ${z})`);
      } catch (error) {
        return createErrorResponse(error as Error);
      }
    }
  );