enable linking branch via mcp
Ninguém assumiu esta issue ainda.
Avaliação
- Dificuldade
- 3/5
- Tempo estimado
- 1-2 dias
- Facilidade para iniciantes
- 72/100
Direção de pesquisa
Comece pela ferramenta create_branch existente e pelo tratamento de suas requisições; em seguida, compare os parâmetros atuais com o endpoint POST /repos/{owner}/{repo}/issues/{issue_number}/branches do GitHub. Está concluído quando create_branch puder aceitar um issue_number opcional, criar o branch vinculado quando ele for fornecido e preservar o comportamento existente quando ele for omitido.
Escrita pelo modelo de indexação a partir do texto da issue.
Descrição
###Describe the feature or problem you'd like to solve
When working with GitHub issues in an agentic workflow, creating a branch that is properly linked to an issue via the Development section requires either the GraphQL createLinkedBranch mutation or the REST endpoint POST /repos/{owner}/{repo}/issues/{issue_number}/branches. The current create_branch tool only accepts branch, from_branch, owner, and repo — with no way to associate the branch with an issue.
As a result, branches created by AI agents appear unlinked in the GitHub UI, breaking the issue → branch → PR traceability chain that teams rely on for project tracking.
Proposed solution
Add an optional issue_number parameter to the existing create_branch tool (or expose a new create_linked_branch tool) that calls POST /repos/{owner}/{repo}/issues/{issue_number}/branches. When provided, the created branch automatically appears in the issue's Development section, closing the gap in the issue lifecycle.
This mirrors the behavior of gh issue develop #N --branch-name my-branch in the GitHub CLI.
Example prompts or workflows (for tools/toolsets only)
Agentic development loop — "Fix issue #42" → agent creates issue, calls create_branch with issue_number: 42, pushes commits, opens PR with Closes #42. The full issue lifecycle is traceable in the GitHub UI without any manual steps.
Project board automation — Teams using GitHub Projects can see the branch linked directly on the issue card, giving PMs visibility into which issues are actively being worked on before the PR is opened.
Multi-agent workflows — A planning agent creates the issue and the linked branch, then hands off to a coding agent. The Development section link makes it unambiguous which branch belongs to which issue across agents.
QA-to-dev handoff — A QA agent files a bug report (issue), a dev agent immediately creates a linked branch. The Development link is visible to the QA agent when it checks the issue status later to verify the fix.
Additional context
The GitHub REST API already supports this via POST /repos/{owner}/{repo}/issues/{issue_number}/branches (documented at https://docs.github.com/en/rest/issues/issues#create-a-branch-for-an-issue). This is a thin wrapper — no new authentication scope is required beyond what create_branch already uses. The only addition needed is passing issue_number in the request body.
- Linguagem predominante
- Go
- Estrelas
- 33.1k
- Forks
- 5k
- Merge médio
- 2d 1h
- PRs com merge (30d)
- 25
Guia de contribuição
Primeiros passos
- Leia a issue inteira e depois o guia de contribuição do projeto.
- Comente na issue dizendo que vai assumir — evita que duas pessoas façam o mesmo trabalho.
- Faça um fork do repositório e trabalhe em uma branch.
- Abra um pull request que referencie o número da issue.
Mais de github/github-mcp-server
-
bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 84/100
github/github-mcp-server#3235 ·
-
enhancement
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 88/100
github/github-mcp-server#3042 · 2 comentários ·
-
bug
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 72/100
github/github-mcp-server#3032 · 1 reação ·
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 74/100
github/github-mcp-server#2803 · 1 comentário ·
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 76/100
github/github-mcp-server#2740 ·
Todas as issues de github/github-mcp-server
Issues semelhantes
-
Dificuldade 1/5 Menos de uma hora Facilidade para iniciantes 60/100
github/gh-aw-mcpg#13748 ·
-
agentic-workflows
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 65/100
-
needs-triage
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 75/100
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 65/100
-
Dificuldade 2/5 1-3 horas Facilidade para iniciantes 75/100
googleapis/librarian#7670 · 2 comentários ·