Python Jira MCP

🚀 Python Jira MCP Server

A Model Context Protocol (MCP) server implemented in Python, integrating the Jira API. This server enables AI models to interact with Jira via a standardized protocol.

🚀 Quick Start

This MCP server exposes Jira API operations as tools that can be utilized by AI models supporting the Model Context Protocol. It implements the stdio transmission mechanism for communication with clients such as Cursor.

✨ Features

• JQL Search Tool: Search for Jira issues using JQL queries.
• Get Issue Tool: Retrieve detailed information about specific Jira issues.
• MCP SDK Integration: Compatible with the official MCP Python SDK.
• Degraded Mode: Provides a minimal implementation without the SDK.
• Environment Configuration: Load Jira credentials from environment variables.

📦 Installation

Requirements

• Python 3.8+
• Jira API access (API token, email, and domain)
• Required Python packages:
  • mcp (Model Context Protocol Python SDK)
  • aiohttp (for HTTP requests)
  • pydantic (for validation)
  • python-dotenv (for environment variables)

Steps

1. Clone this repository:

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

2. Install dependencies:

pip install -r requirements.txt

3. Set up Jira credentials:

cp .env.example .env
# Edit your Jira credentials in the .env file

💻 Usage Examples

Running the Server

To start the MCP server, run:

python main.py

Or use the executable file directly:

./main.py

The server will start listening for MCP messages on standard input (stdin) and respond via standard output (stdout).

Integrating with Cursor

To use this MCP server with Cursor:

1. Start the server as described above.
2. Configure the MCP server path in Cursor to point to main.py.
3. Use Jira tools directly in Cursor.

Available Tools

JQL Search

Search for Jira issues using JQL (Jira Query Language). Example:

{
  "type": "tool_call",
  "id": "123",
  "name": "jql_search",
  "parameters": {
    "jql": "project = XYZ AND status = 'In Progress'",
    "max_results": 10,
    "fields": ["summary", "description", "status"]
  }
}

Get Issue

Retrieve detailed information about a specific Jira issue by its ID or key. Example:

{
  "type": "tool_call",
  "id": "456",
  "name": "get_issue",
  "parameters": {
    "issue_id_or_key": "XYZ-123",
    "fields": ["summary", "description", "status", "assignee"],
    "expand": "changelog"
  }
}

📚 Documentation

Project Structure

• main.py: The main server program.
• tools/: Directory containing Jira tools.
• requirements.txt: List of dependencies.
• .env.example: Example environment variable file.

Contribution Guidelines

1. Clone the repository:

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

2. Install dependencies:

pip install -r requirements.txt

3. Start the server for testing:

python main.py

4. Start development and submit changes.

📄 License

This project is released under the LICENSE.

Contact

If you have any questions or suggestions, please contact your.email@example.com.