Jira CLI MCP

A Model Context Protocol (MCP) server that wraps the Jira CLI tool, exposing Jira commands through MCP resources, tools, and prompts for AI assistant integration.

Features

• MCP Resources: Access Jira data through standardized URL endpoints
• MCP Tools: Execute Jira commands (create issues, edit, assign, etc.)
• MCP Prompts: Use templates for common Jira workflows
• Authentication: Uses existing Jira CLI authentication
• Project Configuration: Customize default project and config

Prerequisites

• Python 3.11+
• Jira CLI installed and configured
• Access to a Jira instance

Installation

1. Clone this repository:

   git clone https://github.com/yourusername/jira-cli-mcp.git
   cd jira-cli-mcp
   

2. Install dependencies with uv:

   uv sync
   source .venv/bin/activate  # On Windows: .venv\Scripts\activate
   

Configuration

The server can be configured via environment variables:

• JIRA_CONFIG_FILE: Path to a custom Jira CLI config file
• JIRA_PROJECT: Default Jira project to use

Example:

export JIRA_PROJECT="PROJ"
export JIRA_CONFIG_FILE="/path/to/config.yml"

Usage

Starting the Server

python main.py

By default, the server will start on port 8080.

Available Resources

• jira://issues - List recent issues
• jira://issue/{issue_key} - View issue details
• jira://epics - List epics
• jira://sprints - List sprints
• jira://projects - List projects
• jira://boards - List boards
• jira://search/{jql} - Search issues with JQL

Available Tools

• create_issue - Create a new Jira issue
• edit_issue - Edit an existing Jira issue
• assign_issue - Assign issue to a user
• move_issue - Move/transition issue to new status
• add_comment - Add comment to issue
• search_issues_tool - Search issues with flexible criteria
• clone_issue - Clone an existing issue
• link_issues - Link two issues
• create_epic - Create a new epic
• add_to_sprint - Add issues to sprint

Available Prompts

• create_bug_report - Template for creating a bug report
• create_feature_request - Template for creating a feature request
• daily_standup_search - Search for issues relevant to daily standup
• issue_triage_workflow - Workflow for triaging new issues

Integrating with AI Assistants

This MCP server can be integrated with AI assistants that support the Model Context Protocol. Example integration:

from mcp.client import MCPClient

# Connect to the MCP server
client = MCPClient("http://localhost:8080")

# Use resources
issues = client.fetch_resource("jira://issues")

# Execute tools
result = client.execute_tool("create_issue", {
    "summary": "Fix login bug",
    "issue_type": "Bug",
    "priority": "High"
})

# Get prompts
template = client.get_prompt("create_bug_report", {
    "component": "Authentication", 
    "severity": "High"
})

License

MIT

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.