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:

git clone <url-do-repositorio> cd mcp-issue

Instale as dependências:

pnpm install

Configure as variáveis de ambiente:

cp .env.example .env

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

GITHUB_TOKEN=seu_token_do_github DEFAULT_OWNER=seu_usuario_ou_organizacao DEFAULT_REPO=nome_do_repositorio_padrao

Compile o projeto:

pnpm run build

⚙️ 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:

{ "mcpServers": { "boxtime-mcp": { "command": "node", "args": [ "C:\\Users\\gusta\\Desktop\\projects\\mcp-issue\\dist\\index.js" ], "env": { "GITHUB_TOKEN": "seu_token_aqui", "DEFAULT_OWNER": "seu_usuario", "DEFAULT_REPO": "seu_repositorio" } } } }

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:

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.

Deploy Server

HTTP connection URL

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Tools

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

GitHub MCP Server
asbloom-py
-
security
F
license
-
quality
Enables 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 -
1,400
1
Release Notes MCP Server
nickbaumann98
A
security
F
license
A
quality
Generates comprehensive and formatted release notes from GitHub repositories, efficiently organizing commits by type and including detailed statistics using smart API usage.
Last updated -
2
GitHub MCP Server
tuanle96
A
security
F
license
A
quality
Enables comprehensive GitHub operations through natural language including file management, repository administration, issue tracking, and advanced code searching.
Last updated -
47
0
1
DocGen MCP Server
rjadhavJT
A
security
A
license
A
quality
Automates 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 -
3
3
MIT License

View all related MCP servers

MCP Issue