jira-cli — Jira CLI & MCP Server

Perché jira-cli?

🤖

AI-Native

Oltre 65 tool MCP pronti per Claude Desktop, Copilot, Cursor e qualunque client compatibile. Output compatto ottimizzato per LLM.

☁️

Cloud & Server

Supporto completo per Jira Cloud (Basic Auth) e Jira Server/Data Center (Bearer PAT). Selezione automatica della versione API.

🔐

Multi-Sito

Configura più istanze Jira e passa dall'una all'altra con --site, env var JIRA_SITE o default nel config.

📦

Single Binary

Un solo eseguibile standalone. Zero dipendenze runtime. Pubblicazione cross-platform: Linux, macOS, Windows.

🗜️

Compact Output

Output ridotto rispetto alle API raw. Solo i campi essenziali, formato ottimizzato per il consumo da parte di LLM.

🔍

JQL Potente

Query JQL complete con paginazione classica e cursor-based. Supporto --fetch-all per iterare tutte le pagine.

Installazione

Single Binary

# macOS ARM64 / Linux x64
curl -L "https://github.com/Lupala-coder/jira-cli/releases/latest" -o jira.tar.gz
tar xzf jira.tar.gz
chmod +x jira && sudo mv jira /usr/local/bin/

# Windows
# Scarica jira.exe dai GitHub Releases

Build from source

git clone https://github.com/Lupala-coder/jira-cli
cd jira-cli
dotnet publish src/JiraCli/JiraCli.csproj \
  -c Release -r linux-x64 \
  --self-contained true \
  -p:PublishSingleFile=true \
  -o ./bin -p:UseAppHost=true

Docker

docker build -t jira-cli .
docker run --rm -it \
  -v ~/.config/jira-cli:/root/.config/jira-cli \
  jira-cli issue get PROJ-123

Quick Setup

# 1. Registra il tuo sito Jira Cloud
jira config add --site myco \
  --url https://myco.atlassian.net \
  --email me@myco.com \
  --token ATATT3xFfGF0...

# 2. Oppure Jira Server/Data Center (PAT)
jira config add --site eng \
  --url https://jira.mycompany.com/jira \
  --token <PersonalAccessToken> \
  --auth-mode bearer

# 3. Verifica
jira context

# 4. Avvia MCP server
jira mcp serve

# 5. Oppure usa la CLI direttamente
jira issue get PROJ-123
jira search --jql "assignee = currentUser() ORDER BY updated DESC"

65+ MCP Tools

Tutti i tool accettano --site come override. Rilevamento automatico dal config, env var o default.

🎫 Issue (13)

get_issue create_issue update_issue delete_issue assign_issue transition_issue add_comment get_comments add_worklog get_issue_worklog get_worklog get_issue_transitions get_remote_links

📎 Allegati & Sub-task (5)

add_attachment list_attachments download_attachment download_all_attachments list_subtasks

🔍 Search (2)

search_issues_jql search_issues_jql_post

📁 Projects (10)

get_all_projects get_project create_project update_project delete_project get_project_statuses get_project_components get_project_versions get_project_roles get_project_role

🏷️ Issue Types & Status (6)

get_issue_types get_issue_type get_statuses get_status get_status_categories get_project_types

📊 Board & Sprint (7)

get_all_boards get_board get_board_issues get_sprints get_sprint create_sprint update_sprint

👤 Users (4)

get_current_user get_user get_users_assignable get_user_groups

🔗 Links & Watchers (4)

create_issue_link delete_issue_link add_watcher remove_watcher

🔧 Fields & Filters (6)

get_fields get_field_contexts create_custom_field get_filters get_filter create_filter

⚙️ Config & Admin (7)

jira_context jira_config_list update_filter delete_filter create_webhook get_webhooks delete_webhook

Integrazioni AI

Aggiungi jira-cli come MCP server al tuo client AI preferito.

Claude Desktop

Aggiungi al claude_desktop_config.json:

{
  "mcpServers": {
    "jira": {
      "command": "/usr/local/bin/jira",
      "args": ["mcp", "serve"]
    }
  }
}

GitHub Copilot

Configura in mcp-servers.json:

{
  "mcpServers": {
    "jira": {
      "command": "/usr/local/bin/jira",
      "args": ["mcp", "serve"]
    }
  }
}

Debug Mode

Attiva il logging HTTP dettagliato su stderr:

jira --debug mcp serve

# Output su stderr:
[DBG] → GET https://jira.myco.com/rest/api/2/myself
[DBG] ← 200 OK (312 ms)
[DBG]   Body: {"name":"jdoe",...}