crafty-mcp

Instructions

Implementation Reference

• src/tools/server-files.ts:6-22 (handler)

  The tool 'server_list_files' is registered using server.tool, with the implementation directly defined in the handler function that calls the CraftyClient.

  server.tool(
    "server_list_files",
    "List files and directories in a Minecraft server's directory",
    {
      server_id: z.string().describe("Server ID or UUID"),
      path: z.string().default("").describe("Relative path to list (empty string for root)"),
    },
    async ({ server_id, path }) => {
      try {
        const data = await client.post(`/servers/${server_id}/files`, { path });
        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 };
      }
    }
  );