Minecraft Server MCP

Instructions

Implementation Reference

• src/tools/config-tools.ts:106-129 (handler)

  The set_game_rule tool is defined and handled directly in src/tools/config-tools.ts. It takes a rule name and value as input and sends a 'gamerule' command via RCON.

  server.tool(
    "set_game_rule",
    "Set a game rule value via RCON. Common rules: doDaylightCycle, doWeatherCycle, doMobSpawning, keepInventory, mobGriefing, doFireTick, randomTickSpeed, playersSleepingPercentage.",
    {
      rule: z.string().describe("Game rule name (e.g., 'keepInventory', 'doDaylightCycle')"),
      value: z.string().describe("Game rule value (e.g., 'true', 'false', '3')"),
    },
    async ({ rule, value }) => {
      try {
        const response = await manager.rcon.send(`gamerule ${rule} ${value}`);
        return { content: [{ type: "text", text: response }] };
      } catch (error) {
        return {
          content: [
            {
              type: "text",
              text: `Failed to set game rule: ${error instanceof Error ? error.message : String(error)}`,
            },
          ],
          isError: true,
        };
      }
    }
  );