Gitee

Instructions

Implementation Reference

• operations/branches.ts:47-65 (handler)

  Core handler function that performs the actual branch creation by validating inputs, constructing API URL and body, sending POST request to Gitee API, and parsing response.

  export async function createBranchFromRef(
    owner: string,
    repo: string,
    branchName: string,
    refs: string = "master"
  ) {
    owner = validateOwnerName(owner);
    repo = validateRepositoryName(repo);
    branchName = validateBranchName(branchName);
  
    const url = `/repos/${owner}/${repo}/branches`;
    const body = {
      branch_name: branchName,
      refs: refs,
    };
  
    const response = await giteeRequest(url, "POST", body);
    return GiteeBranchSchema.parse(response);
  }

• operations/branches.ts:6-15 (schema)

  Zod schema for input validation of the create_branch tool parameters: owner, repo, branch_name, refs.

  export const CreateBranchSchema = z.object({
    // 仓库所属空间地址 (企业、组织或个人的地址 path)
    owner: z.string().describe("Repository owner path (enterprise, organization, or personal path)"),
    // 仓库路径 (path)
    repo: z.string().describe("Repository path"),
    // 新创建的分支名称
    branch_name: z.string().describe("Name for the new branch"),
    // 起点名称，默认：master
    refs: z.string().default("master").describe("Source reference for the branch, default: master"),
  });

• index.ts:62-70 (registration)

  Tool registration in MCP server, specifying name, description, schema, and thin handler wrapper that delegates to createBranchFromRef.

  server.registerTool({
    name: "create_branch",
    description: "在 Gitee 仓库中创建一个新分支",
    schema: branchOperations.CreateBranchSchema,
    handler: async (params: any) => {
      const { owner, repo, branch_name, refs } = params;
      return await branchOperations.createBranchFromRef(owner, repo, branch_name, refs);
    },
  });