Jira

A really simple MCP server for Jira, which uses docker for easy deployment.

python

1

GitHub Stars

python

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "maximepeabody-simple-jira-mcp": {
      "command": "uvicorn",
      "args": [
        "src.server:app",
        "--reload"
      ],
      "env": {
        "JIRA_SERVER": "https://yourcompany.atlassian.net",
        "JIRA_API_KEY": "yourapikey",
        "JIRA_USERNAME": "yourname@yourcompany.com",
        "JIRA_PROJECT_KEY": "yourprojectkey"
      }
    }
  }
}

You can run a Jira MCP Server that lets AI assistants interact with Jira to fetch tickets, add comments, view possible status transitions, and update ticket statuses. This guide shows practical ways to run the server locally and use it with MCP clients.

How to use

Start the Jira MCP Server locally to enable AI assistants to manage Jira tickets. You will run a local MCP endpoint that receives requests from your MCP client and translates them into Jira actions like fetching assigned tickets, adding comments, listing transitions, and updating statuses. Use the MCP client to send requests to the local endpoint and observe ticket data changes in Jira.

How to install

Prerequisites you need to have before starting are Docker and a Jira account with API access. You will also configure environment variables for Jira connectivity.

Step by step run flow (two options):

# Option A: Using Python (recommended for local development)
# 1) Install dependencies
pip install -r requirements.txt

# 2) Run the server
uvicorn src.server:app --reload

# This starts the server on http://localhost:8000

Additional content

Configuration and running notes: The server relies on Jira connection details you provide via environment variables. Ensure you have a Jira server URL, a Jira username, an API key, and the Jira project key you want to work with. You can start the server in two different ways depending on your workflow.

Environment variables you will configure in a root .env file are the following.

JIRA_SERVER=https://yourcompany.atlassian.net
JIRA_USERNAME=yourname@yourcompany.com
JIRA_API_KEY=yourapikey
JIRA_PROJECT_KEY=yourprojectkey

MCP connection methods

You can run the Jira MCP Server locally in two ways. The Python option runs a local process via a standard Python environment, while the Docker option wraps the server in a script that builds and runs the container locally.

Available tools

fetch_tickets

Fetches tickets assigned to the user or matching a query, returning basic ticket details.

add_comment

Adds a comment to a specified Jira ticket using the MCP bridge.

get_transitions

Retrieves available status transitions for a given Jira ticket.

update_status

Updates the status of a Jira ticket to a selected transition.