Minecraft Server MCP

Instructions

Implementation Reference

• src/tools/player-tools.ts:246-270 (handler)

  The tool 'apply_effect' is registered and implemented in src/tools/player-tools.ts. It executes an RCON 'effect give' command.

  server.tool(
    "apply_effect",
    "Apply a status effect to a player. Examples: speed, strength, regeneration, night_vision, invisibility, resistance.",
    {
      target: z.string().describe("Player selector"),
      effect: z.string().describe("Effect ID (e.g., 'speed', 'night_vision')"),
      duration: z.number().optional().default(30).describe("Duration in seconds"),
      amplifier: z.number().optional().default(0).describe("Amplifier level (0 = level I)"),
    },
    async ({ target, effect, duration, amplifier }) => {
      try {
        const response = await manager.rcon.send(
          `effect give ${target} ${effect} ${duration} ${amplifier}`
        );
        return { content: [{ type: "text", text: response }] };
      } catch (error) {
        return {
          content: [
            {
              type: "text",
              text: `Failed: ${error instanceof Error ? error.message : String(error)}`,
            },
          ],
          isError: true,
        };