Which integrations are available for this server?

Generates Git diffs from working directory, staged changes, or commit ranges with file filtering and size controls Creates GitHub issues automatically using the GitHub API, with support for labels, assignees, and structured issue templates generated from Git diffs

How do I use MCP Issue?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@MCP Issue create an issue from the staged changes in the current branch" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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

Related MCP server: Release Notes MCP Server

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.

Install Server

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

How are these scores calculated?

Resources

GitHub Repository

Need Help?

Report Issue

Related Servers

MCP Issue