Jira Context MCP

Servidor MCP para fornecer informações de tickets do Jira para agentes de codificação de IA como o Cursor.

GitHub
26
Experimente este MCPPatrocinado

Documentação

MseeP.ai Security Assessment Badge

Jira Context MCP

CodeQL Advanced smithery badge Verified on MseeP

Uma implementação do Model Context Protocol (MCP) para Jira que permite:

  • Inserir um link de ticket do Jira para buscar detalhes da issue e instruir o Cursor a corrigi-la
  • Recuperar todos os tickets atribuídos a você em um projeto Jira específico
  • Filtrar issues do Jira com base em um tipo de issue específico e direcionar automaticamente o Cursor para resolvê-las
  • Integrar-se perfeitamente com a API do Jira para automação e eficiência

Configuração

Pré-requisitos

  • Node.js 20.17.0 ou superior
  • Uma conta Jira com acesso à API
  • Um token de API do Jira (pode ser gerado em Atlassian API Tokens)

Instalação

Instalando via Smithery

Para instalar o Jira Context MCP para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install @rahulthedevil/Jira-Context-MCP --client claude

Instalando manualmente

  1. Clone este repositório:

    git clone https://github.com/yourusername/Jira-Context-MCP.git
cd Jira-Context-MCP

  2. Instale as dependências:

    npm install
# or if you use pnpm
pnpm install

  3. Crie um arquivo .env com base no exemplo:

    cp .env.example .env

  4. Edite o arquivo .env com seus dados do Jira:

    JIRA_BASE_URL=https://your-domain.atlassian.net
JIRA_USERNAME=your-email@example.com
JIRA_API_TOKEN=your-api-token-here
HTTP_PORT=3000

Build

Compile o projeto com:

npm run build
# or
pnpm build

Uso

Iniciando o Servidor

Inicie o servidor HTTP:

npm start
# or
pnpm start

Ou use o modo CLI:

npm run start:cli
# or
pnpm start:cli

Conectando com o Cursor

  1. No Cursor, abra a Paleta de Comandos (Ctrl+Shift+P ou Cmd+Shift+P)
  2. Digite "Connect to MCP Server"
  3. Selecione "Connect to MCP Server"
  4. Insira a URL do servidor (padrão: http://localhost:3000/sse)

Ferramentas Disponíveis

Após conectar, você pode usar as seguintes ferramentas no Cursor:

1. Obter Detalhes da Issue do Jira

Busque informações detalhadas sobre uma issue específica do Jira:

/get_issue issueKey:PROJECT-123

2. Obter Issues Atribuídas

Recupere issues atribuídas a você em um projeto específico:

/get_assigned_issues projectKey:PROJECT maxResults:10

3. Obter Issues por Tipo

Filtre issues por tipo (Bug, Story, Epic, etc.):

/get_issues_by_type issueType:Bug projectKey:PROJECT maxResults:10

4. Obter Projetos

Liste todos os projetos disponíveis:

/get_projects

5. Obter Tipos de Issue

Liste todos os tipos de issue disponíveis:

/get_issue_types

6. Obter Alterações Recentes em Tickets

Recupere alterações feitas em tickets durante um período especificado (por exemplo, os últimos 7 dias) em um projeto:

/get_recent_changes projectKey:PROJECT maxDays:7

Exemplos de Comandos

🚀 Jira MCP Server + Cursor IDE = Seu assistente Jira com IA! Veja como isso faz os devs trabalharem de forma mais inteligente:

📂 "Liste todos os projetos Jira aos quais tenho acesso"
→ A IA busca todos os projetos disponíveis instantaneamente
Chega de procurar manualmente!

📋 "Liste todas as issues em PROJECT"
→ A IA recupera todos os tickets abertos
Mantenha-se organizado sem esforço!

🐛 "Filtre apenas Bugs ou Solicitações de Mudança e corrija-os"
→ A IA identifica e direciona o Cursor para resolvê-los
Corrija problemas mais rápido com automação!

✅ "Encontre todos os tickets atribuídos a mim e corrija-os"
→ A IA puxa suas tarefas e deixa o Cursor lidar com elas
Fique por dentro do seu trabalho sem complicação!

🔍 "Obtenha detalhes da issue Jira PROJECT-123"
→ A IA busca informações completas da issue em segundos
Chega de alternar entre abas!

📊 "O que mudou nos tickets nos últimos 7 dias em PROJECT?"
→ A IA rastreia atualizações recentes e destaca mudanças importantes
Chega de verificar manualmente o histórico dos tickets!

🔥 Resumo: Sua IA agora fala Jira + Cursor! Busque projetos, filtre issues, acompanhe mudanças e corrija bugs—tudo dentro da sua IDE.
Do backlog às correções de bugs, o MCP Server faz o Jira trabalhar para você!

Exemplos de Fluxos de Trabalho

Corrigir um Bug Específico

  1. Conecte-se ao servidor Jira MCP no Cursor.
  2. Obtenha os detalhes da issue: 
    /get_issue issueKey:PROJECT-123
  3. Revise os detalhes da issue e instrua o Cursor a corrigi-la: 
    Fix the bug described in PROJECT-123

Trabalhar nas Suas Issues Atribuídas

  1. Conecte-se ao servidor Jira MCP no Cursor.
  2. Recupere suas issues atribuídas: 
    /get_assigned_issues projectKey:PROJECT
  3. Peça ao Cursor para ajudar com uma das issues: 
    Help me solve the first issue in my assigned list

Corrigir Todos os Bugs em um Projeto

  1. Conecte-se ao servidor Jira MCP no Cursor.
  2. Recupere todas as issues de bug: 
    /get_issues_by_type issueType:Bug projectKey:PROJECT
  3. Instrua o Cursor: 
    Help me fix these bugs one by one

Revisar Alterações Recentes

  1. Conecte-se ao servidor Jira MCP no Cursor.
  2. Recupere atualizações recentes de tickets: 
    /get_recent_changes projectKey:PROJECT maxDays:7
  3. Revise as alterações para se manter atualizado sobre as modificações.

Desenvolvimento

Estrutura do Projeto

  • src/ - Código-fonte
    • services/ - Serviço da API do Jira
    • types/ - Definições de tipos TypeScript
    • utils/ - Funções utilitárias
    • server.ts - Implementação do servidor MCP
    • index.ts - Ponto de entrada da aplicação
    • cli.ts - Ponto de entrada da CLI

Adicionando Novas Ferramentas

Para adicionar novas ferramentas, edite o arquivo src/server.ts e adicione novas definições de ferramentas no método registerTools.

Licença

MIT

Autor

Rahul Dey - @rahulthedevil