create_branch
Create a new branch in a Gitee repository by specifying the owner, repository, and branch name, with an optional reference source for the branch.
Instructions
在 Gitee 仓库中创建一个新分支
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| branch_name | Yes | Name for the new branch | |
| owner | Yes | Repository owner path (enterprise, organization, or personal path) | |
| refs | No | Source reference for the branch, default: master | master |
| repo | Yes | Repository path |
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); }, });