About Jira MCP Server
Jira MCP Server is a Spring AI-based MCP server for teams that need AI tools to work with Jira issues. It supports JQL searches, issue creation and updates, and adding comments.
Key features
- 01Searches issues with JQL
- 02Retrieves issues by key
- 03Creates and updates issues
- 04Adds comments to issues
- 05Authenticates with Jira API tokens
Use cases
- 01Find Jira issues with a JQL query
- 02Create or edit issues through tools
- 03Add a comment to an existing issue
MCP support
The server exposes Jira issue search and operations as MCP tools for AI models and MCP clients.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEJira 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 JQLgetIssue: Retrieve a specific ticket by key
Ticket Operations Service
createIssue: Create a new Jira ticketupdateIssue: Update an existing ticketaddComment: Add a comment to a ticket
Dependencies
- Spring AI MCP Server WebFlux Starter
- Spring Boot
- Spring WebFlux
- Spring AI Core
Contributing
- Fork the repository
- Create your feature branch
- Commit your changes
- Push to the branch
- Create a new Pull Request
License
This project is licensed under the Apache License 2.0 - see the LICENSE file for details.
Comments
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.