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:

1. 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

2. 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:

1. 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

1. Clone o repositório:

2. Instale as dependências:

3. Configure as variáveis de ambiente:

Edite o arquivo .env com suas configurações:

4. 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 TypeScript

• pnpm run dev - Executa em modo desenvolvimento

• pnpm run start - Executa a versão compilada

Configuração do Token GitHub

Para obter um token do GitHub:

1. Acesse GitHub → Settings → Developer settings → Personal access tokens

2. 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.