Skip to main content
Glama
enesjakozh

Python Jira MCP Server

by Chase-Bullock
GitHub
Python
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Python Jira MCP Server

A Model Context Protocol (MCP) server implementation in Python that integrates with Jira API. This allows AI models to interact with Jira through a standardized protocol.

Overview

This MCP server exposes Jira API operations as tools that can be used by AI models supporting the Model Context Protocol. The server implements the stdio transport mechanism to communicate with clients like Cursor.

Features

  • JQL Search Tool: Search for Jira issues using JQL queries
  • Get Issue Tool: Retrieve detailed information about a specific Jira issue
  • MCP SDK Integration: Compatible with the official MCP Python SDK
  • Fallback Mode: Minimal implementation when the SDK is not available
  • Environment Configuration: Load Jira credentials from environment variables

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)

Installation

  1. Clone this repository:
    git clone https://github.com/yourusername/python-jira-mcp.git cd python-jira-mcp
  2. Install the dependencies:
    pip install -r requirements.txt
  3. Set up your Jira credentials:
    cp .env.example .env # Edit .env with your Jira credentials

Usage

Running the Server

To start the MCP server, run:

python main.py

Or use the executable directly:

./main.py

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

Integrating with Cursor

To use this MCP server with Cursor:

  1. Start the server (as above)
  2. In Cursor, configure the MCP server path to point to main.py
  3. Use Jira tools directly within Cursor

Available Tools

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 details 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" } }

Development

Project Structure

  • main.py: Entry point for the MCP server
  • src/server.py: Main MCP server implementation
  • src/tools/jira_tools.py: Jira API tool implementations
  • src/tool_schemas.py: Tool schemas definition

Adding New Tools

To add a new Jira-related tool:

  1. Implement the tool function in src/tools/jira_tools.py
  2. Add the tool schema in src/tool_schemas.py
  3. Register the tool in src/server.py

License

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

Acknowledgments

This server cannot be installed

-
security - not tested
F
license - not found
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Una implementación de servidor que permite que los modelos de IA interactúen con Jira a través del Protocolo de contexto de modelo, lo que habilita tareas como búsquedas JQL y recuperación de detalles de problemas.

  1. Descripción general
    1. Características
      1. Requisitos
        1. Instalación
          1. Uso
            1. Ejecución del servidor
            2. Integración con Cursor
            3. Herramientas disponibles
          2. Desarrollo
            1. Estructura del proyecto
            2. Agregar nuevas herramientas
          3. Licencia
            1. Expresiones de gratitud

              Related Resources

              Related MCP Servers

              • Jira MCP Server

                uddeshya-23
                -
                security
                F
                license
                -
                quality
                Enables AI models to interact with Jira using a standardized protocol, offering full Jira REST API integration with features like optimal performance through connection pooling, error handling, and request monitoring.
                Last updated -
                2

              • Jira MCP Server

                ParasSolanki
                A
                security
                A
                license
                A
                quality
                A Model Context Protocol server that provides integration with Jira, allowing Large Language Models to interact with Jira projects, boards, sprints, and issues through natural language.
                Last updated -
                5
                314
                2
                MIT License
                • Apple

              • Jira MCP Server

                samuelrizzo
                A
                security
                A
                license
                A
                quality
                A Model Context Protocol server that enables AI assistants like Claude to interact with Jira, allowing for project management tasks such as listing projects, searching issues, creating tickets, and managing sprints through natural language queries.
                Last updated -
                7
                11
                1
                TypeScript
                MIT License
                • Linux
                • Apple

              • Jira MCP Server

                maximepeabody
                -
                security
                A
                license
                -
                quality
                A Simple Model Context Protocol server that enables AI assistants to interact with Jira, allowing operations like fetching tickets, adding comments, and updating ticket status.
                Last updated -
                1
                Apache 2.0

              View all related MCP servers

              Appeared in Searches

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/Chase-Bullock/python-jira-mcp'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server