MCP Jira Integration

This project integrates Claude AI with Jira to automate and enhance project management tasks.

Features

Core Functionality

Jira issue creation and management through MCP protocol
API key-based authentication
Standardized request/response format for AI interactions

Jira Integration Features

Issue creation and updates
Basic sprint tracking
Project and board management
Issue search and retrieval

Requirements

Python 3.8 or higher
Jira account with API token
Valid MCP implementation

Setup

Clone the repository
Configure environment variables in .env:
JIRA_URL=https://your-domain.atlassian.net JIRA_USERNAME=your.email@domain.com JIRA_API_TOKEN=your_api_token PROJECT_KEY=PROJ API_KEY=your_secure_api_key # For MCP authentication

API Usage

Create Issue

from mcp_jira.protocol import MCPRequest, MCPContext

# Create request context
context = MCPContext(
    conversation_id=\"conv-123\",
    user_id=\"user-123\",
    api_key=\"your_api_key\"
)

# Create issue request
request = MCPRequest(
    function=\"create_issue\",
    parameters={
        \"summary\": \"Implement feature X\",
        \"description\": \"Detailed description\",
        \"issue_type\": \"Story\",
        \"priority\": \"High\"
    },
    context=context
)

response = await mcp_handler.process_request(request)

Search Issues

request = MCPRequest(
    function=\"search_issues\",
    parameters={
        \"jql\": \"project = PROJ AND status = 'In Progress'\"
    },
    context=context
)

response = await mcp_handler.process_request(request)

Authentication

All requests require an API key in the request header:

headers = {
    \"X-API-Key\": \"your_api_key\"
}

Integration with AI Assistants

This MCP implementation is designed to work with AI assistants that support the MCP protocol:

Configure the environment variables
Set up the MCP endpoint in your AI assistant's configuration
Use the standardized MCP protocol for Jira interactions

Contributing

Fork the repository
Create a feature branch
Submit a pull request

License

MIT License - see LICENSE file, message: Update README to reflect current functionality` }