Package Exports

jira-server-mcp
jira-server-mcp/src/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (jira-server-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

Jira Server MCP (Model Context Protocol)

Um MCP (Model Context Protocol) para integração com Jira Server auto-hospedado, desenvolvido especificamente para uso com o Cursor IDE.

Características

Suporte completo para Jira Server (testado na versão 9.5.1)
Autenticação via Bearer Token
Comandos para gerenciamento de issues, busca e transições
Configuração simplificada via variáveis de ambiente
Compatível com o protocolo MCP do Cursor

Instalação e Configuração

Método 1: Usando npx (Recomendado)

Configure o MCP no arquivo .cursor/mcp.json do seu projeto:

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["jira-server-mcp"],
      "env": {
        "JIRA_BASE_URL": "http://seu-jira-server:8080",
        "JIRA_API_TOKEN": "seu-token-aqui"
      }
    }
  }
}

Método 2: Clonando o Repositório

Clone este repositório dentro da pasta .cursor/mcp-jira do seu projeto:

mkdir -p .cursor/mcp-jira
git clone https://github.com/valter-tonon/jira-server-mcp.git .cursor/mcp-jira

Instale as dependências:

cd .cursor/mcp-jira
npm install

Configure o MCP no arquivo .cursor/mcp.json:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": [".cursor/mcp-jira/src/index.js"],
      "env": {
        "JIRA_BASE_URL": "http://seu-jira-server:8080",
        "JIRA_API_TOKEN": "seu-token-aqui"
      }
    }
  }
}

Comandos Disponíveis

test: Testa a conexão com o Jira Server
get-issue <issue-key>: Obtém detalhes de uma issue específica
search <jql>: Busca issues usando JQL (Jira Query Language)
get-transitions <issue-key>: Lista as transições disponíveis para uma issue
get-changelog <issue-key>: Obtém o histórico de mudanças de uma issue

Exemplos de Uso

Usando npx

# Testar conexão
npx jira-server-mcp test

# Buscar Issue
npx jira-server-mcp get-issue CLI-24238

# Buscar com JQL
npx jira-server-mcp search "project = CLI AND status = 'In Progress'"

Usando o Repositório Local

# Testar conexão
node src/index.js test

# Buscar Issue
node src/index.js get-issue CLI-24238

# Buscar com JQL
node src/index.js search "project = CLI AND status = 'In Progress'"

Configuração

O MCP suporta dois formatos de configuração:

1. Variáveis de Ambiente Individuais

{
  "env": {
    "JIRA_BASE_URL": "http://seu-jira-server:8080",
    "JIRA_API_TOKEN": "seu-token-aqui"
  }
}

2. Configuração JSON Completa (via MCP_CONFIG)

{
  "env": {
    "MCP_CONFIG": "{\"jira\":{\"baseUrl\":\"http://seu-jira-server:8080\",\"authentication\":{\"basic\":{\"apiToken\":\"seu-token-aqui\"}}}}"
  }
}

Desenvolvimento

Estrutura do Projeto

.cursor/mcp-jira/
├── src/
│   └── index.js    # Código principal do MCP
├── package.json    # Dependências e scripts
└── README.md      # Esta documentação

Requisitos

Node.js >= 14
npm >= 6
Jira Server >= 9.0

Contribuindo

Faça um fork do projeto
Crie uma branch para sua feature (git checkout -b feature/nova-feature)
Commit suas mudanças (git commit -am 'Adiciona nova feature')
Push para a branch (git push origin feature/nova-feature)
Crie um Pull Request

Licença

Este projeto está licenciado sob a licença MIT - veja o arquivo LICENSE para detalhes.

Suporte

Para reportar bugs ou solicitar features, por favor abra uma issue no GitHub.