jira-mcp-server

# 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)](https://docs.spring.io/spring-ai/reference/1.0/api/mcp/mcp-overview.html) 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: ```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 ```bash ./gradlew build ``` ## Running the Application ```bash ./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.