trackmcp
Back to directory
maximepeabody

simple-jira-mcp

View on GitHub

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

1 stars PythonServers & Infrastructure Updated Apr 1, 2025

Documentation

Jira MCP Server

A Simple Model Context Protocol (MCP) server that allows AI assistants to interact with Jira. This server enables AI to perform actions like:

  • Fetching user's assigned tickets
  • Adding comments to tickets
  • Getting available status transitions
  • Updating ticket status

Prerequisites

  • Docker
  • Jira account with API access
  • Environment variables configured (see below)

Environment Variables

Create a `.env` file in the root directory with the following:

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

Get your API key from: https://id.atlassian.com/manage-profile/security/api-tokens

Running Locally

Option 1: Using Docker

bash
# Build and run with Docker
chmod +x run_docker_locally.sh
./run_docker_locally.sh

Option 2: Using Python

1. Install dependencies:

bash
pip install -r requirements.txt

2. Run the server:

bash
uvicorn src.server:app --reload

This will start the server on `http://localhost:8000`.

Using the MCP Server

The MCP server is exposed at `http://localhost:8000/mcp`.

Frequently asked questions

What is simple-jira-mcp?

simple-jira-mcp is A really simple MCP server for Jira, which uses docker for easy deployment.

How do I install simple-jira-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is simple-jira-mcp open source?

Yes — it is hosted on GitHub at https://github.com/maximepeabody/simple-jira-mcp and has 1 stars.

Related MCP tools

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP