JFrog MCP Server

Instructions

Implementation Reference

• tools/builds.ts:16-26 (handler)

  Core function implementing the tool logic: constructs the JFrog API URL for the specific build, makes a GET request using jfrogRequest, and parses the response with the output schema.

  export async function getSpecificBuild(buildName: string, project?: string) {
    const url = project 
      ? `/artifactory/api/build/${buildName}?project=${project}`
      : `/artifactory/api/build/${buildName}`;
  
    const response = await jfrogRequest(url, {
      method: "GET",
    });
       
    return buildsSchemas.JFrogBuildDetailsSchema.parse(response);
  }

• schemas/builds.ts:3-6 (schema)

  Zod input schema for the tool, defining buildName (required) and project (optional).

  export const GetSpecificBuildSchema = z.object({
    buildName: z.string().describe("Name of the build to retrieve"),
    project: z.string().optional().describe("Optional project key to scope the build search")
  });

• tools/builds.ts:32-41 (registration)

  Local registration of the tool: defines name, description, input schema, and handler wrapper that parses args and delegates to getSpecificBuild.

  const getSpecificBuildTool = {
    name: "jfrog_get_specific_build",
    description: "Get details for a specific build by name, optionally scoped to a project",
    inputSchema: zodToJsonSchema(buildsSchemas.GetSpecificBuildSchema),
    //outputSchema: zodToJsonSchema(buildsSchemas.JFrogBuildDetailsSchema),
    handler: async (args: any) => {
      const parsedArgs = buildsSchemas.GetSpecificBuildSchema.parse(args);
      return await getSpecificBuild(parsedArgs.buildName, parsedArgs.project);
    }
  };

• tools/index.ts:13-23 (registration)

  Global registration: imports BuildsTools (containing jfrog_get_specific_build) and spreads it into the main tools array exported for use.

  export const tools =[
    ...RepositoryTools,
    ...BuildsTools,
    ...RuntimeTools,
    ...AccessTools,
    ...AQLTools,
    ...CatalogTools,
    ...CurationTools,
    ...PermissionsTools,
    ...ArtifactSecurityTools,
  ];

• schemas/builds.ts:8-14 (schema)

  Output schema used to parse the JFrog API response for build details.

  export const JFrogBuildDetailsSchema = z.object({
    uri: z.string(),
    buildsNumbers: z.array(z.object({
      uri: z.string(),
      started: z.string().describe("Build start timestamp in ISO8601 format")
    }))
  });