MCP Issue - GitHub Issue Creator from Git Diff
Um servidor MCP (Model Context Protocol) que permite criar issues no GitHub automaticamente a partir de diffs do Git. Desenvolvido por Gustavo Detoni.
Sobre o Projeto
Este projeto é um servidor MCP que oferece ferramentas para:
- Gerar diffs do Git (working directory, staged changes ou range de commits)
- Criar prompts estruturados para gerar issues a partir de diffs
- Criar issues no GitHub automaticamente usando a API do GitHub
Funcionalidades
Ferramentas Disponíveis:
git_diff
- Gera diffs do repositório Git- Suporte para diferentes modos: working, staged, range
- Filtros por arquivos específicos
- Controle de tamanho máximo do output
create_github_issue
- Cria issues no GitHub- Integração com a API do GitHub via Octokit
- Suporte a labels e assignees
- Configuração de repositório padrão
Prompts Disponíveis:
draft_issue_from_diff
- Converte diffs em rascunhos de issues estruturadas- Template padronizado com seções: Summary, Context, Observations, etc.
- Detecção automática do tipo de mudança (bug/feat/chore/refactor)
- Sugestão de labels apropriadas
Instalação
Pré-requisitos
- Node.js (versão 18+)
- pnpm
- Git configurado no sistema
- Token do GitHub com permissões para criar issues
Passos de Instalação
- Clone o repositório:
- Instale as dependências:
- Configure as variáveis de ambiente:
Edite o arquivo .env
com suas configurações:
- Compile o projeto:
⚙️ Configuração no Claude Desktop
Para usar este servidor MCP com o Claude Desktop, adicione a seguinte configuração no arquivo de configuração do Claude:
Importante: Substitua o caminho no array args
pelo caminho absoluto correto para o arquivo dist/index.js
no seu sistema.
Scripts Disponíveis
pnpm run build
- Compila o TypeScriptpnpm run dev
- Executa em modo desenvolvimentopnpm run start
- Executa a versão compilada
Configuração do Token GitHub
Para obter um token do GitHub:
- Acesse GitHub → Settings → Developer settings → Personal access tokens
- Gere um novo token com as permissões:
repo
(para repositórios privados)public_repo
(para repositórios públicos)issues
(para criar e gerenciar issues)
Template de Issue
O projeto usa um template estruturado para issues com as seguintes seções:
- Summary: Resumo conciso da implementação
- Context: Contexto da mudança ou problema resolvido
- Observations: Pontos importantes da implementação
- Acceptance Criteria: Critérios de aceitação baseados no diff
- Action Plan: Ações/tarefas implementadas
- Dependencies/Risks: Dependências e riscos identificados
- Technical Notes: Detalhes técnicos relevantes
Contribuição
Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou pull requests.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
Enables automatic GitHub issue creation from Git diffs. Generates structured issue templates with summaries, technical notes, and appropriate labels based on code changes.
Related MCP Servers
- -securityFlicense-qualityEnables interaction with GitHub through the GitHub API, supporting file operations, repository management, advanced search, and issue tracking with comprehensive error handling and automatic branch creation.Last updated -95491
- AsecurityFlicenseAqualityGenerates comprehensive and formatted release notes from GitHub repositories, efficiently organizing commits by type and including detailed statistics using smart API usage.Last updated -32
- AsecurityFlicenseAqualityEnables comprehensive GitHub operations through natural language including file management, repository administration, issue tracking, and advanced code searching.Last updated -4741
- AsecurityAlicenseAqualityAutomates the creation of standardized documentation by extracting information from source files and applying templates, with integration capabilities for GitHub, Google Drive, and Perplexity AI.Last updated -33MIT License