JFrog MCP Server

Instructions

Implementation Reference

• tools/runtime.ts:36-50 (handler)

  Core handler function that builds the query parameters and performs the API request to list running JFrog Runtime images, parsing the response with the output schema.

  export async function getRunningImages(params: z.infer<typeof ListRunningImagesSchema>) {
    const queryString = new URLSearchParams({
      num_of_rows: params.num_of_rows.toString(),
      statistics: params.statistics.toString(),
      timePeriod: params.timePeriod,
      filters: params.filters,
      page_num: params.page_num.toString()
    }).toString();
  
    const response = await jfrogRequest(`/runtime/api/v1/live/images?${queryString}`, {
      method: "GET"
    });
     
    return JFrogRuntimeImagesResponseSchema.parse(response);
  }

• schemas/runtime.ts:108-114 (schema)

  Zod input schema defining parameters for listing running images: num_of_rows, statistics, timePeriod, filters, page_num.

  export const ListRunningImagesSchema = z.object({
    num_of_rows: z.number().int().default(100).describe("Number of rows to return"),
    statistics: z.boolean().default(true).describe("Whether to include statistics"),
    timePeriod: z.string().default("now").describe("Time period to query"),
    filters: z.string().default("").describe("Filters to apply"),
    page_num: z.number().int().default(1).describe("Page number")
  });

• tools/runtime.ts:77-86 (registration)

  Tool registration object specifying the name, description, input schema, and a thin handler that parses args and delegates to getRunningImages.

  const listRunningImagesTool = {
    name: "jfrog_list_running_images",
    description: "List all running container images across runtime clusters with their security and operational status",
    inputSchema: zodToJsonSchema(ListRunningImagesSchema),
    //outputSchema: zodToJsonSchema(JFrogRuntimeImagesResponseSchema),
    handler: async (args: any) => {
      const parsedArgs = ListRunningImagesSchema.parse(args);
      return await getRunningImages(parsedArgs);
    }
  };

• tools/runtime.ts:90-94 (registration)

  Exports the array of runtime tools, registering jfrog_list_running_images alongside others.

  export const RuntimeTools = [
    getAllRuntimeClustersTool,
    getRuntimeClusterTool,
    listRunningImagesTool
  ];