Development · MODEL CONTEXT PROTOCOL

Jira MCP Server

MCP server for JIRA

WHAT IT CONNECTS

What Jira MCP Server gives an AI Agent

The source catalog does not include a structured feature list. Review the repository documentation before use.

SECURITY

An MCP listing is not a security review

An MCP server may receive model context, credentials, local files, or permission to call external systems. Review its code, requested environment variables, network behavior, package provenance, and maintenance status before connecting it to an agent.

README

Repository documentation

Jira MCP Server

A Spring AI Model Context Protocol (MCP) server implementation that provides AI-powered tools for interacting with Jira. This project enables AI models to perform various Jira operations through a standardized protocol.

Overview

This project implements a Spring AI MCP server that exposes Jira operations as AI tools. It provides capabilities for:

  • Querying Jira tickets
  • Creating new tickets
  • Updating existing tickets
  • Adding comments to tickets

The server follows the Model Context Protocol (MCP) specification, enabling standardized interaction between AI models and Jira operations.

Features

  • Ticket Query Service: Search and retrieve Jira tickets using JQL
  • Ticket Operations Service: Create, update, and comment on Jira tickets
  • Spring AI MCP server implementation
  • RESTful API endpoints for Jira operations
  • Secure authentication using Jira API tokens

Prerequisites

  • Java 21 or later
  • Gradle 8.12.1 or later
  • Jira instance with API access
  • Jira API token

Configuration

Configure the application using environment variables or application.properties:

# JIRA Configuration
jira.api-url=${JIRA_API_URL}
jira.username=${ALTASSIAN_USERNAME}
jira.api-token=${ALTASSIAN_TOKEN}

# Server Configuration
server.port=8081

Building the Project

./gradlew build

Running the Application

./gradlew bootRun

Project Structure

src/main/java/com/mcp/
├── app/
│   └── JiraServiceApplication.java
├── config/
│   ├── AppConfig.java
│   └── JiraApiConfiguration.java
├── dto/
│   ├── CommonDTO.java
│   ├── IssueManagementDTO.java
│   └── IssueSearchDTO.java
└── service/
    ├── BaseJiraService.java
    ├── TicketOperationsService.java
    └── TicketQueryService.java

Available Tools

Ticket Query Service

  • searchIssues: Search Jira tickets using JQL
  • getIssue: Retrieve a specific ticket by key

Ticket Operations Service

  • createIssue: Create a new Jira ticket
  • updateIssue: Update an existing ticket
  • addComment: Add a comment to a ticket

Dependencies

  • Spring AI MCP Server WebFlux Starter
  • Spring Boot
  • Spring WebFlux
  • Spring AI Core

Contributing

  1. Fork the repository
  2. Create your feature branch
  3. Commit your changes
  4. Push to the branch
  5. Create a new Pull Request

License

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

View README on GitHub

COMMUNITY

Save, rate, and discuss

Loading community data…