Skip to main content
Glama

MCP Issue

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:
git clone <url-do-repositorio> cd mcp-issue
  1. Instale as dependências:
pnpm install
  1. 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
  1. 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:

  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.

-
security - not tested
F
license - not found
-
quality - not tested

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.

  1. Sobre o Projeto
    1. Funcionalidades
      1. Ferramentas Disponíveis:
      2. Prompts Disponíveis:
    2. Instalação
      1. Pré-requisitos
      2. Passos de Instalação
    3. ⚙️ Configuração no Claude Desktop
      1. Scripts Disponíveis
        1. Configuração do Token GitHub
          1. Template de Issue
            1. Contribuição

              Related MCP Servers

              • -
                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 -
                9
                549
                1
              • 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 -
                3
                2
              • 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
                4
                1
              • 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
                • Apple

              View all related MCP servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/gustavodetoni/mcp-issue'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server