MCP Jira

🚀 MCP Jira Integration

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

🚀 Quick Start

This project integrates Claude AI with Jira, aiming to automate and enhance project management tasks. It provides a series of functions to help users better manage Jira issues.

✨ Features

Core Features

• Create and manage Jira issues through the MCP protocol.
• Authenticate based on API Key.
• Use a standard request/response format for AI interaction.

Jira Integration Features

• Create and update issues.
• Track basic sprints.
• Manage projects and boards.
• Search for and retrieve issues.

📦 Installation

Requirements

• Python 3.8 or higher.
• A Jira account with an API Token.
• A valid MCP implementation.

Steps

1. Clone the repository.
2. 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  # Used for MCP authentication
   

💻 Usage Examples

Basic Usage

Create an Issue

from mcp_jira.protocol import MCPRequest, MCPContext

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

# Create an 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 for 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"
}

📚 Documentation

Integration with AI Assistants

This MCP implementation is designed for AI assistants that support the MCP protocol:

1. Configure environment variables.
2. Set the MCP endpoint in the AI assistant configuration.
3. Use the standardized MCP protocol for Jira interaction.

Contribution Guidelines

1. Fork the repository.
2. Create a feature branch.
3. Submit a pull request.

📄 License

This project is under the MIT License - see the LICENSE file for details.