list-branches
Retrieve branch information from GitHub Enterprise repositories to view, filter, and manage branches for development workflows.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| owner | Yes | User or organization name | |
| repo | Yes | Repository name | |
| protected_only | No | Whether to show only protected branches | |
| page | No | Page number | |
| perPage | No | Items per page |
Implementation Reference
- server/index.js:232-291 (handler)Main execution logic for list-branches tool: input validation, fetches branches via RepositoryAPI, formats using formatBranch, handles errors and empty results.}, async ({ owner, repo, protected_only, page, perPage }) => { try { // 매개변수 검증 if (!owner || typeof owner !== 'string' || owner.trim() === '') { return { content: [ { type: "text", text: "오류: 저장소 소유자(owner)는 필수 항목입니다." } ], isError: true }; } if (!repo || typeof repo !== 'string' || repo.trim() === '') { return { content: [ { type: "text", text: "오류: 저장소 이름(repo)은 필수 항목입니다." } ], isError: true }; } const branches = await context.repository.listBranches(owner, repo, protected_only, page, perPage); // 브랜치가 없는 경우 if (!branches || branches.length === 0) { return { content: [ { type: "text", text: `저장소 '${owner}/${repo}'에 브랜치가 없습니다.` } ] }; } // 브랜치 정보 형식화 const formattedBranches = branches.map(formatBranch); return { content: [ { type: "text", text: `저장소 '${owner}/${repo}'의 브랜치 목록 (${branches.length}개)${protected_only ? ' (보호된 브랜치만)' : ''}:\n\n${JSON.stringify(formattedBranches, null, 2)}` } ] }; } catch (error) { console.error('브랜치 목록 조회 오류:', error); return { content: [ { type: "text", text: `브랜치 목록 조회 중 오류가 발생했습니다: ${error.message}` } ], isError: true }; }
- server/index.js:227-231 (schema)Zod schema defining input parameters for the list-branches tool.owner: z.string().describe("저장소 소유자 (사용자 또는 조직)"), repo: z.string().describe("저장소 이름"), protected_only: z.boolean().default(false).describe("보호된 브랜치만 표시할지 여부"), page: z.number().default(1).describe("페이지 번호"), perPage: z.number().default(30).describe("페이지당 항목 수")
- server/index.js:226-292 (registration)MCP server.tool registration for the list-branches tool, including schema and inline handler.server.tool("list-branches", { owner: z.string().describe("저장소 소유자 (사용자 또는 조직)"), repo: z.string().describe("저장소 이름"), protected_only: z.boolean().default(false).describe("보호된 브랜치만 표시할지 여부"), page: z.number().default(1).describe("페이지 번호"), perPage: z.number().default(30).describe("페이지당 항목 수") }, async ({ owner, repo, protected_only, page, perPage }) => { try { // 매개변수 검증 if (!owner || typeof owner !== 'string' || owner.trim() === '') { return { content: [ { type: "text", text: "오류: 저장소 소유자(owner)는 필수 항목입니다." } ], isError: true }; } if (!repo || typeof repo !== 'string' || repo.trim() === '') { return { content: [ { type: "text", text: "오류: 저장소 이름(repo)은 필수 항목입니다." } ], isError: true }; } const branches = await context.repository.listBranches(owner, repo, protected_only, page, perPage); // 브랜치가 없는 경우 if (!branches || branches.length === 0) { return { content: [ { type: "text", text: `저장소 '${owner}/${repo}'에 브랜치가 없습니다.` } ] }; } // 브랜치 정보 형식화 const formattedBranches = branches.map(formatBranch); return { content: [ { type: "text", text: `저장소 '${owner}/${repo}'의 브랜치 목록 (${branches.length}개)${protected_only ? ' (보호된 브랜치만)' : ''}:\n\n${JSON.stringify(formattedBranches, null, 2)}` } ] }; } catch (error) { console.error('브랜치 목록 조회 오류:', error); return { content: [ { type: "text", text: `브랜치 목록 조회 중 오류가 발생했습니다: ${error.message}` } ], isError: true }; } });
- server/index.js:42-50 (helper)Helper function to format branch objects for user-friendly output.function formatBranch(branch) { return { name: branch.name, commit: { sha: branch.commit.sha }, protected: branch.protected }; }
- api/repos/repository.js:68-76 (helper)RepositoryAPI method that performs the actual GitHub API call to list branches.async listBranches(owner, repo, protected_only = false, page = 1, perPage = 30) { return this.client.get(`repos/${owner}/${repo}/branches`, { params: { protected: protected_only, page, per_page: perPage } }); }