mcpField
J
jira-mcp-server

jira-mcp-server

Local
github.com/chasepdVersion Control0Updated 79w ago
Repository

About jira-mcp-server

jira-mcp-server connects LLMs to Jira through API tools for issue management and tracking. It supports JQL search and operations to create, retrieve, update, and delete issues.

Key features

  1. 01Search issues with JQL
  2. 02Create Jira issues
  3. 03Retrieve issue details
  4. 04Update existing issues
  5. 05Delete issues

Use cases

  1. 01Find Jira issues matching a JQL query
  2. 02Create issues from an automated workflow
  3. 03Review or update a specific issue
  4. 04Remove an issue through an API tool

MCP support

The MCP server exposes Jira issue search, creation, retrieval, update, and deletion tools to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

jira-mcp-server

An MCP server that enables LLMs to interact with Jira through a set of API tools. This server provides a bridge between language models and Jira's functionality, allowing for automated issue management and tracking.

Features

  • Search Jira issues using JQL
  • Create new issues
  • Get issue details
  • Update existing issues
  • Delete issues

Setup in Cursor

Add a new entry to your mcp.json file:

"jira": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "JIRA_BASE_URL",
        "-e",
        "JIRA_EMAIL",
        "-e",
        "JIRA_TOKEN",
        "chasepd/jira-mcp-server:latest"
      ]
      "env":{
        "JIRA_BASE_URL": "[THE BASE URL OF YOUR JIRA INSTANCE]",
        "JIRA_EMAIL": "[EMAIL OF YOUR JIRA ACCOUNT]",
        "JIRA_TOKEN": "[YOUR JIRA API TOKEN]"
      }
    }

Prerequisites

  • Python 3.x
  • Jira account with API access
  • Environment variables for Jira authentication:
    • JIRA_BASE_URL
    • JIRA_EMAIL
    • JIRA_TOKEN

Dev Setup

  1. Clone the repository:
git clone https://github.com/yourusername/jira-mcp-server.git
cd jira-mcp-server
  1. Install dependencies:
pip install -r requirements.txt
  1. Set up environment variables:
export JIRA_BASE_URL="your-jira-instance-url"
export JIRA_EMAIL="[email protected]"
export JIRA_TOKEN="your-api-token"

Running the Server

Local Development
python src/mcp-server.py
Using Docker

The server is available as a Docker image at chasepd/jira-mcp-server.

Pull and run the latest version:

docker pull chasepd/jira-mcp-server:latest
docker run -e JIRA_BASE_URL="your-jira-instance-url" \
           -e JIRA_EMAIL="[email protected]" \
           -e JIRA_TOKEN="your-api-token" \
           -p 8000:8000 \
           chasepd/jira-mcp-server:latest

Available Tools

The server provides the following tools for interacting with Jira:

  • jira_search_issues(jql: str): Search for issues using JQL
  • jira_create_issue(project_key: str, summary: str, description: str, issuetype: str): Create a new issue
  • jira_get_issue(issue_key: str): Get details of a specific issue
  • jira_update_issue(issue_key: str, fields: dict): Update an existing issue
  • jira_delete_issue(issue_key: str): Delete an issue

Contributing

Contributions are welcome! Please feel free to submit a pull request if there's a new feature you'd like to see.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.