simple-jira-mcp

simple-jira-mcp

1
os_automation

The Jira MCP Server is a Model Context Protocol server designed for AI interactions with Jira. It supports various ticket-related actions and can be run using Docker or Python.

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:

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

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

Option 2: Using Python

  1. Install dependencies:
pip install -r requirements.txt
  1. Run the server:
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.