Minecraft MCP Server

Instructions

Implementation Reference

• mcp-server/src/skills/verified/goToKnownLocation.ts:22-70 (handler)

  The main handler function that implements the goToKnownLocation tool logic. Validates parameters, navigates to coordinates using navigateToLocation or to a person using goToPerson.

  export const goToKnownLocation = async (
    bot: Bot,
    params: ISkillParams,
    serviceParams: ISkillServiceParams,
  ): Promise<boolean> => {
    const skillName = 'goToKnownLocation';
    const requiredParams = ['x', 'y', 'z'];
    const isParamsValid = validateSkillParams(
      params,
      requiredParams,
      skillName,
    );
    if (!isParamsValid) {
      serviceParams.cancelExecution?.();
      bot.emit(
        'alteraBotEndObservation',
        `Mistake: You didn't provide all of the required parameters ${requiredParams.join(', ')} for the ${skillName} skill.`,
      );
      return false;
    }
  
    const unpackedParams = {
      x: params.x,
      y: params.y,
      z: params.z,
      name: params.name,
      signal: serviceParams.signal,
    };
    const {x, y, z, name, signal} = unpackedParams;
  
    if (!name) {
      await navigateToLocation(bot, {
        x,
        y,
        z,
        signal,
        range: 1,
        verbose: true,
        allowTeleport: false,
      });
    } else {
      await goToPerson(bot, {
        name,
        distance: 3,
        keepFollowing: false,
        signal,
      });
    }
  };

• mcp-server/src/skillRegistry.ts:104-113 (schema)

  Defines the input schema for the goToKnownLocation skill, including parameters, descriptions, and required fields. Used to register the skill dynamically.

  goToKnownLocation: {
      description: "Navigate to specific coordinates",
      params: {
          x: { type: "number", description: "X coordinate" },
          y: { type: "number", description: "Y coordinate" },
          z: { type: "number", description: "Z coordinate" },
          name: { type: "string", description: "Optional: Name of the location" }
      },
      required: ["x", "y", "z"]
  },

• mcp-server/src/skillRegistry.ts:104-113 (registration)

  The SKILL_METADATA entry that registers the goToKnownLocation skill by providing its metadata for dynamic loading and execution.

  goToKnownLocation: {
      description: "Navigate to specific coordinates",
      params: {
          x: { type: "number", description: "X coordinate" },
          y: { type: "number", description: "Y coordinate" },
          z: { type: "number", description: "Z coordinate" },
          name: { type: "string", description: "Optional: Name of the location" }
      },
      required: ["x", "y", "z"]
  },