JFrog MCP Server

Instructions

Implementation Reference

• tools/repositories.ts:38-51 (handler)

  Core handler function implementing the API logic to set properties on an Artifactory folder using PUT /api/storage/{path} with properties and recursive query parameters.

  export async function setFolderProperty(folderPath: string, properties: Record<string, string>, recursive = false) {
    // Convert properties object to query string format
    const propsQuery = Object.entries(properties)
      .map(([key, value]) => `${key}=${value}`)
      .join(";");
  
    const url = `/artifactory/api/storage/${folderPath}?properties=${propsQuery}&recursive=${recursive ? 1 : 0}`;
  
    const response = await jfrogRequest(url, {
      method: "PUT"
    });
  
    return response;
  }

• schemas/repositories.ts:75-79 (schema)

  Zod schema for tool input validation: folderPath (string), properties (record<string, string>), recursive (boolean, default false).

  export const SetFolderPropertySchema = z.object({
    folderPath: z.string().describe("Path to the folder where properties should be set"),
    properties: z.record(z.string()).describe("Key-value pairs of properties to set"),
    recursive: z.boolean().default(false).describe("Whether to apply properties recursively to sub-folders")
  });

• tools/repositories.ts:113-122 (registration)

  Tool definition object registering 'jfrog_set_folder_property' with name, description, input schema, and handler that validates args and delegates to setFolderProperty.

  const setFolderPropertyTool = {
    name: "jfrog_set_folder_property",
    description: "Set properties on a folder in Artifactory, with optional recursive application",
    inputSchema: zodToJsonSchema(SetFolderPropertySchema),
    //outputSchema: zodToJsonSchema(z.object({})),
    handler: async (args: any) => {
      const parsedArgs = SetFolderPropertySchema.parse(args);
      return await setFolderProperty(parsedArgs.folderPath, parsedArgs.properties, parsedArgs.recursive);
    }
  };

• tools/repositories.ts:168-175 (registration)

  Registers the jfrog_set_folder_property tool (as setFolderPropertyTool) within the RepositoryTools array.

  export const RepositoryTools =[ 
    checkJfrogAvailabilityTool,
    createLocalRepositoryTool,
    createRemoteRepositoryTool,
    createVirtualRepositoryTool,
    setFolderPropertyTool,
    listRepositoriesTool
  ];

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

  Main tools registry includes RepositoryTools (spreading all repository tools including jfrog_set_folder_property).

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