Jira Um servidor Model Context Protocol (MCP) que fornece integração com Jira, permitindo que LLMs interajam com issues, executem transições, adicionem worklogs e realizem buscas usando a API REST do Jira.

📦 Instalação

Via PyPI (Recomendado)

pip install mcp-server-jira

Via GitHub

pip install git+https://github.com/your-username/mcp-jira-v3.git

Desenvolvimento

git clone https://github.com/your-username/mcp-jira-v3.git
cd mcp-jira-v3
pip install -e .

🚀 Uso Rápido

# Executar com token padrão
mcp-server-jira --jira-token "SEU_TOKEN_AQUI"

# Executar com URL customizada
mcp-server-jira --jira-base-url "https://jira.sua-empresa.com" --jira-token "SEU_TOKEN"

# Ajuda
mcp-server-jira --help

📋 O que é o Projeto Server

Um servidor Model Context Protocol (MCP) que fornece integração com Jira, permitindo que LLMs interajam com issues, executem transições, adicionem worklogs e realizem buscas usando a API REST do Jira.

� O que é o Projeto

Este é um servidor MCP que atua como ponte entre Large Language Models (LLMs) e o Jira, oferecendo automação de tarefas e consultas através de comandos em linguagem natural.

⚡ Funcionalidades

O servidor oferece 5 ferramentas principais:

1. get_issue - Consultar Issue

• Ação: Obtém informações detalhadas de uma issue do Jira
• Parâmetros: issue_key (ex: "PROJ-123"), token (opcional)

2. get_transitions - Listar Transições

• Ação: Lista transições disponíveis para uma issue
• Parâmetros: issue_key, token (opcional)

3. transition_issue - Executar Transição

• Ação: Executa uma transição na issue (muda status)
• Parâmetros: issue_key, transition_id, token (opcional)

4. add_worklog - Adicionar Worklog

• Ação: Adiciona registro de trabalho à issue
• Parâmetros: issue_key, time_spent (ex: "2h 30m"), description, token (opcional)

5. search_issues - Buscar Issues

• Ação: Busca issues usando JQL (Jira Query Language)
• Parâmetros: jql (ex: "assignee = currentUser()"), token (opcional)

🏗️ Arquitetura do Programa

mcp-jira-v3/
├── src/mcp_server_jira/
│   ├── __init__.py          # Entry point com função main()
│   └── server.py            # JiraServer class com 5 ferramentas MCP
├── test/
│   └── jira_server_test.py  # Testes unitários completos
├── pyproject.toml           # Configuração do projeto e dependências
└── dist/
    └── mcp_server_jira-0.1.0.tar.gz  # Pacote de distribuição (12.9 KB)

Arquitetura Interna:

• JiraServer: Classe principal que implementa o servidor MCP
• Modelos Pydantic: JiraIssue, JiraTransition, WorklogResult, etc.
• Cliente HTTP: httpx com SSL bypass para ambientes corporativos
• Autenticação Flexível: Token padrão configurável + token por requisição

🛠️ Bibliotecas e Frameworks

Dependências Principais

• mcp>=1.0.0 - Model Context Protocol framework
• pydantic>=2.0.0 - Validação de dados e modelos
• httpx>=0.25.0 - Cliente HTTP assíncrono

Dependências de Desenvolvimento

• pytest>=8.3.3 - Framework de testes

Características Técnicas

• Python 3.10+ - Versão mínima suportada
• Async/Await - Programação assíncrona
• Type Hints - Tipagem completa
• SSL Bypass - Para ambientes corporativos

🔧 Como Configurar Ambiente de DEV

1. Preparar Ambiente

# Clone o repositório
git clone <repo-url>
cd mcp-jira-v3

# Instalar Python 3.10+
# Verificar versão
python --version

2. Instalar Dependências

# Instalar em modo de desenvolvimento
pip install -e .

# Instalar dependências de teste
pip install pytest

3. Obter Token Jira

1. Acesse sua conta Jira
2. Vá em Configurações → Segurança → Tokens de API
3. Crie um novo token
4. Copie o token gerado

📦 Como Instalar a Aplicação

Instalação via Pacote Distribuído

# Instalar do arquivo .tar.gz
pip install mcp_server_jira-0.1.0.tar.gz

# Verificar instalação
mcp-server-jira --help

Verificar Instalação

# Testar comando básico
mcp-server-jira --jira-base-url "https://jira.exemplo.com" --jira-token "SEU_TOKEN"

▶️ Como Executar a Aplicação

Execução Básica

# Com URL padrão (https://jira.telefonica.com.br)
mcp-server-jira --jira-token "SEU_TOKEN_AQUI"

# Com URL customizada
mcp-server-jira --jira-base-url "https://jira.sua-empresa.com" --jira-token "SEU_TOKEN"

# Sem token padrão (fornecido por requisição)
mcp-server-jira --jira-base-url "https://jira.sua-empresa.com"

Parâmetros Disponíveis

• --jira-base-url: URL base do Jira (padrão: https://jira.telefonica.com.br)
• --jira-token: Token de autenticação (opcional, pode ser fornecido por requisição)

🧪 Como Testar a Aplicação

Executar Testes Unitários

# Rodar todos os testes
pytest test/ -v

# Rodar testes específicos
pytest test/jira_server_test.py::TestValidationFunctions -v

Testar Funcionalidade Manualmente

# Testar ajuda
mcp-server-jira --help

# Testar conexão (substitua pelo seu token)
mcp-server-jira --jira-token "SEU_TOKEN_REAL"

⚙️ Configuração MCP no VS Code

Configuração Local (Projeto Específico)

1. Criar arquivo de configuração local:

mkdir .vscode
nano .vscode/mcp.json

2. Adicionar configuração no .vscode/settings.json:

{
	"servers": {
		"mcp-jira-dev":  {
           "command": "py",
             "args": ["-m", "mcp_server_jira", "--jira-token", "SEU TOKEN"]

    }
	},
	"inputs": []
}

Configuração Global (Todos os Projetos)

1. Abrir configurações globais do VS Code:

   • Pressione Ctrl+Shift+P (Windows/Linux) ou Cmd+Shift+P (Mac)
   • Digite "Preferences: Open User Settings (JSON)"
   • Selecione para abrir o settings.json ou mcp.json global

2. Adicionar configuração no settings.json global:

{
	"servers": {
		"mcp-jira-dev":  {
           "command": "py",
             "args": ["-m", "mcp_server_jira", "--jira-token", "SEU TOKEN"]

    }
	},
	"inputs": []
}

Configuração Sem Token Padrão (Mais Seguro)

{
	"servers": {
		"mcp-jira-dev":  {
           "command": "py",
             "args": ["-m", "mcp_server_jira"]

    }
	},
	"inputs": []
}

Com esta configuração, você fornecerá o token a cada uso das ferramentas.

📋 Informações do Projeto

• Versão: 0.1.0
• Tamanho: 12.9 KB
• Licença: MIT
• Python: 3.10+