MCP Issue
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
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: Agentic MCP Server
Funcionalidades
Ferramentas Disponíveis:
git_diff- Gera diffs do repositório GitSuporte para diferentes modos: working, staged, range
Filtros por arquivos específicos
Controle de tamanho máximo do output
create_github_issue- Cria issues no GitHubIntegraçã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 estruturadasTemplate 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-issueInstale as dependências:
pnpm installConfigure as variáveis de ambiente:
cp .env.example .envEdite o arquivo .env com suas configurações:
GITHUB_TOKEN=seu_token_do_github
DEFAULT_OWNER=seu_usuario_ou_organizacao
DEFAULT_REPO=nome_do_repositorio_padraoCompile 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 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.
Available Tools
2 toolscreate_github_issueCreate GitHub IssueC
Cria uma issue no GitHub usando Octokit
Inputs: title (required), assignees, body, labels, +2 more.
git_diffGet Git diffB
Retorna um diff do repositório atual. Use para entender alterações locais.
Inputs: base, head, maxBytes, mode, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools have completely distinct purposes: one creates GitHub issues via Octokit, while the other returns a diff of the current repository. There is no overlap in functionality or ambiguity between them.
Both tools use snake_case naming, which is consistent. However, one tool includes 'github' in its name while the other does not, creating a minor deviation in naming pattern. The verbs 'create' and 'git_diff' (which is more of a noun phrase) are not perfectly aligned in style.
With only 2 tools, the server feels thin for a domain that appears to involve GitHub and repository operations. This limited set does not provide comprehensive coverage for typical workflows, such as reading or updating issues, managing repositories, or handling other common tasks.
The tool set is severely incomplete for a server named 'MCP Issue' and including GitHub-related functionality. There are significant gaps: no tools to list, get, update, or delete issues, and no broader GitHub operations like managing pull requests or repositories. This will likely cause agent failures in many scenarios.
Related MCP Connectors
Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.
Issue tracker for coding agents: a real backlog, plus a risk-ranked review of every change.
Assign Linear, Jira or GitHub issues to an AI coding agent team that plans, builds, reviews, tests.
A Model Context Protocol (MCP) application for automated GitHub PR analysis and issue management.…
Related MCP Servers
- AlicenseBqualityFmaintenanceEnables LLMs to interact with GitHub issues by providing details as tasks, allowing for seamless integration and task management through GitHub's platform.160 npm14MIT
- -licenseBqualityNot gradedmaintenanceEnables AI-driven orchestration of GitHub development workflows including automated issue analysis, code generation, code review, and PR creation through multiple specialized agents. Integrates with GitHub Actions to automate the complete development process from issue to pull request.7-

CodePeel MCP Serverofficial
AlicenseAqualityDmaintenanceEnables AI agents to review code diffs for bugs, security issues, and bad patterns, and generate fixes.4MIT- FlicenseBqualityDmaintenanceEnables issue-to-code automation for GitHub and GitLab by connecting AI assistants (Claude Code, Gemini CLI, Codex) via MCP, with slash commands for issue analysis, planning, implementation, testing, documentation, and PR creation.339-