Jira_mcp_streamlit

# Jira Assistant with MCP Integration

A Streamlit-based assistant for managing Jira tickets using MCP (Model Control Panel) for tool calling.

## Features

- 🤖 Clean tabbed interface for different operations
- 🎯 Create, search, and manage Jira tickets with simple conversational commands
- 🔄 Real-time ticket creation without relying on external LLMs
- 🛠️ Built on the MCP framework for flexible tool calling
- 📊 Direct form-based interface for creating and searching tickets

## Screenshots

### Tabbed Interface
The application now features a clean tabbed interface with separate sections for:
1. Chat - Conversational interface for managing tickets
2. Create Ticket - Form-based ticket creation
3. Search Tickets - Advanced search using JQL

![Jira Assistant Demo](jira_server_demo.gif)

## Prerequisites

- Python 3.8+
- Jira account with API access
- MCP server running with Jira tools

## Installation

1. Clone the repository
2. Install the required packages:
   ```bash
   pip install -r requirements.txt
   ```
3. Set up your environment variables in a `.env` file:
   ```
   JIRA_URL=https://your-domain.atlassian.net
   JIRA_EMAIL=your-email@example.com
   JIRA_API_TOKEN=your-jira-api-token
   ```

## Running the Application

Use the start script to launch the application:

```bash
./start_jira_assistant.sh
```

The script will:
1. Check if the MCP package is installed
2. Verify required environment variables
3. Start the MCP server if it's not already running
4. Launch the Streamlit application

## Usage Examples

### Creating Tickets

You can create tickets in two ways:

#### Using the Chat Interface
Type natural language commands like:
- "Create a new task in KAN titled 'Implement user authentication' with description 'We need to add a JWT-based authentication system for user login.'"
- "I need a bug ticket in KAN for 'Fix pagination in user list' describing 'The pagination controls are not working correctly when there are more than 10 users.'"

#### Using the Form Interface
1. Navigate to the "Create Ticket" tab
2. Fill in the required fields (Project Key, Summary, Description)
3. Select the issue type
4. Click "Create Ticket"

### Searching Tickets

You can search tickets in two ways:

#### Using the Chat Interface
Type natural language queries like:
- "Find all open tickets in the KAN project"
- "Show me all high priority bugs"
- "Search for tickets mentioning 'authentication' in the KAN project"

#### Using the Search Interface
1. Navigate to the "Search Tickets" tab
2. Enter a JQL query (examples are provided in the interface)
3. Set the maximum number of results
4. Click "Search"

### Getting Ticket Details

Ask for details about specific tickets:
- "Show details for ticket KAN-123"
- "What's the status of KAN-456?"

## Direct Jira Tool

For command-line operations, use the direct_jira_tool.py script:

```bash
# List available tools
./direct_jira_tool.py list

# Create a ticket
./direct_jira_tool.py create --project KAN --title "Fix login

... [View full README on GitHub]