jira-mcp-tools 0.2.1

Model Context Protocol server for Jira integration

MCP Server for JIRA

A Model Context Protocol (MCP) server that provides seamless integration with Jira. This server enables AI assistants to retrieve issue information, comments, and attachments from any Jira instance.

Features

• 🎫 Get Issue Information: Retrieve detailed issue descriptions and comments
• 📎 Download Attachments: Access and download issue attachments
• 🔒 Secure Authentication: Uses Jira API tokens for secure access
• 🌐 Universal Compatibility: Works with Jira Cloud, Server, and Data Center

Installation

Using uvx (Recommended)

uvx mcp-jira

Using pip

pip install mcp-jira

Prerequisites

• Python 3.10 or higher
• Jira account with API access
• Jira API token (How to create)

Configuration

Environment Variables

The server requires three environment variables:

• JIRA_URL: Your Jira instance URL (e.g., https://your-company.atlassian.net/)
• JIRA_EMAIL: Your Jira account email
• JIRA_TOKEN: Your Jira API token

MCP Client Configuration

Add to your MCP client configuration (e.g., Claude Desktop, Bob):

{
  "mcpServers": {
    "jira": {
      "command": "uvx",
      "args": ["mcp-jira"],
      "env": {
        "JIRA_URL": "https://your-jira-instance.com/",
        "JIRA_EMAIL": "[e-mail]",
        "JIRA_TOKEN": "your-api-token"
      }
    }
  }
}

Available Tools

get_jira_ticket_info

Retrieves comprehensive information about a Jira issue.

Parameters:

• issue_key (string): The Jira issue key (e.g., "PROJ-123")

Returns:

• Issue description
• All comments with author and timestamp
• Comment bodies

Example:

get_jira_ticket_info("PROJ-123")

get_jira_ticket_attachments

Downloads and retrieves attachments from a Jira issue.

Parameters:

• issue_key (string): The Jira issue key (e.g., "PROJ-123")

Returns:

• List of attachments with filenames and content

Example:

get_jira_ticket_attachments("PROJ-456")

Development

Setup

1. Clone the repository

2. Install dependencies:

   uv sync
   

3. Create a .env file based on env.template:

   cp env.template .env
   # Edit .env with your credentials
   

Running Locally

uv run server.py

Testing

# Run tests
uv run pytest

# Run with coverage
uv run pytest --cov

Use Cases

• AI-Assisted Development: Let AI assistants fetch and analyze Jira issues
• Automated Workflows: Integrate Jira data into automated processes
• Context-Aware Coding: Provide issue context to AI coding assistants
• Documentation: Auto-generate documentation from Jira issues

Roadmap

• Support for creating and updating issues
• Advanced search capabilities
• Support for Jira workflows and transitions
• Enhanced attachment handling (PDFs, images)
• Bulk operations support

Contributing

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

License

MIT License - see LICENSE file for details.

Support

• Issues: GitHub Issues
• Documentation: Full Documentation

Acknowledgments

Built with:

• FastMCP - Fast MCP server framework
• jira-python - Python Jira library
• Model Context Protocol - MCP specification