crafty-mcp

Instructions

Implementation Reference

• src/tools/server-actions.ts:19-32 (handler)

  The handler implementation for the tools, including "server_start". It uses the client to perform a post request to the server action endpoint.

  server.tool(
    name,
    description,
    serverIdSchema,
    async ({ server_id }) => {
      try {
        const data = await client.post(`/servers/${server_id}/action/${action}`);
        return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
      } catch (error) {
        const msg = error instanceof Error ? error.message : String(error);
        return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true };
      }
    }
  );

• src/tools/server-actions.ts:8-16 (registration)

  Registration of the "server_start" tool action mapping.

  const actions: Array<{ name: string; action: string; description: string }> = [
    { name: "server_start", action: "start_server", description: "Start a Minecraft server" },
    { name: "server_stop", action: "stop_server", description: "Stop a Minecraft server (sends configured stop command)" },
    { name: "server_restart", action: "restart_server", description: "Restart a Minecraft server" },
    { name: "server_kill", action: "kill_server", description: "Force-kill a Minecraft server process immediately" },
    { name: "server_backup", action: "backup_server", description: "Trigger an immediate backup of a Minecraft server's files" },
    { name: "server_update_executable", action: "update_executable", description: "Update the server jar/executable from the configured download URL" },
    { name: "server_clone", action: "clone_server", description: "Clone an existing Minecraft server (server must not be running)" },
  ];