AlibabaCloud DevOps MCP Server

Instructions

Implementation Reference

• tool-handlers/code-management.ts:13-24 (handler)

  MCP tool handler for 'create_branch': parses arguments using CreateBranchSchema and delegates to branches.createBranchFunc, returning the result as JSON text.

  case "create_branch": {
    const args = types.CreateBranchSchema.parse(request.params.arguments);
    const branch = await branches.createBranchFunc(
      args.organizationId,
      args.repositoryId,
      args.branch,
      args.ref
    );
    return {
      content: [{ type: "text", text: JSON.stringify(branch, null, 2) }],
    };
  }

• tool-registry/code-management.ts:7-11 (registration)

  Tool registration entry for 'create_branch' including name, description, and input schema derived from CreateBranchSchema.

  {
    name: "create_branch",
    description: "[Code Management] Create a new branch in a Codeup repository",
    inputSchema: zodToJsonSchema(types.CreateBranchSchema),
  },

• operations/codeup/types.ts:219-224 (schema)

  Zod input schema definition for create_branch tool parameters: organizationId, repositoryId, branch, ref.

  export const CreateBranchSchema = z.object({
    organizationId: z.string().describe("Organization ID, can be found in the basic information page of the organization admin console"),
    repositoryId: z.string().describe("Repository ID or a combination of organization ID and repository name, for example: 2835387 or organizationId%2Frepo-name (Note: slashes need to be URL encoded as %2F)"),
    branch: z.string().describe("Name of the branch to be created"),
    ref: z.string().default("master").describe("Source branch name, the new branch will be created based on this branch, default value is master"),
  });

• operations/codeup/branches.ts:19-52 (helper)

  Core helper function createBranchFunc that constructs the API URL, handles repositoryId encoding, makes POST request to create branch, and parses response with CodeupBranchSchema.

  export async function createBranchFunc(
      organizationId: string,
      repositoryId: string,
      branch: string,
      ref: string = "master"
  ): Promise<z.infer<typeof CodeupBranchSchema>>{
    // Automatically handle unencoded slashes in repositoryId
    if (repositoryId.includes("/")) {
      // Found unencoded slash, automatically URL encode it
      const parts = repositoryId.split("/", 2);
      if (parts.length === 2) {
        const encodedRepoName = encodeURIComponent(parts[1]);
        // Remove + signs from encoding (spaces are encoded as +, but we need %20)
        const formattedEncodedName = encodedRepoName.replace(/\+/g, "%20");
        repositoryId = `${parts[0]}%2F${formattedEncodedName}`;
      }
    }
  
    const baseUrl = `/oapi/v1/codeup/organizations/${organizationId}/repositories/${repositoryId}/branches`;
  
    // Build query parameters
    const queryParams: Record<string, string | number | undefined> = {
      branch: branch,
      ref: ref
    };
  
    const url = buildUrl(baseUrl, queryParams);
    console.error("createBranchFunc url:" + url);
  
    const response = await yunxiaoRequest(url, {
      method: "POST",
    });
    return CodeupBranchSchema.parse(response);
  }