This Jira MCP server exposes Jira operations as MCP tools that AI models can invoke through the MCP protocol. It provides a set of capabilities to query Jira tickets, create new tickets, update existing tickets, and add comments to tickets via standardized MCP actions. The available tools are divided into two services: Ticket Query Service (searchIssues, getIssue) and Ticket Operations Service (createIssue, updateIssue, addComment). To use these tools, connect your MCP client to the Jira MCP server, set the Jira credentials and API URL (through environment variables or configuration), and call the tool endpoints with appropriate prompts or structured requests. For example, you can query tickets using JQL expressions, fetch details of a specific issue by key, create new issues with required fields, update fields on existing issues, or append comments to tickets. The server handles authentication against your Jira instance and returns structured responses suitable for AI consumption.

Prerequisites:

• Java 21 or later
• Gradle 8.12.1 or later
• Access to a Jira instance with API permissions

Installation steps:

1. Clone the repository: git clone https://github.com/axample/azammehr-jira-mcp-server.git cd azammehr-jira-mcp-server

2. Build the project (local development): ./gradlew build

3. Run the application locally (example): java -jar build/libs/your-artifact-name.jar

   or use Gradle bootRun:

   ./gradlew bootRun

4. Optional: package a Docker image for deployment:

   Dockerfile should be present in the repo; if not, build an image from your jar

   docker build -t azammehr/jira-mcp-server:latest .

5. If using Docker to run (as suggested in mcp_config): docker run -i -e JIRA_API_URL="https://your-jira-instance.atlassian.net"
   -e ALTASSIAN_USERNAME="your-email@example.com"
   -e ALTASSIAN_TOKEN="your-jira-api-token"
   -p 8081:8081 azammehr/jira-mcp-server:latest

Prerequisites recap:

• JDK 21+ installed
• Gradle 8.12.1+ installed or use the provided Gradle wrapper
• Jira instance with API access and a valid API token

Configuration tips:

• Ensure Jira API URL is reachable from the MCP server environment.
• Use a Jira API token with appropriate permissions for the operations you intend to perform.
• The server listens on port 8081 by default; adjust SERVER_PORT if needed.
• If running behind a firewall or reverse proxy, configure TLS termination and update the Jira API URL accordingly.
• When using Docker, ensure the image tag matches the one used in your mcp_config.
• For production, consider mounting credentials securely (e.g., through environment secrets) and rotate tokens regularly.
• If you encounter authentication errors, verify that the ALTASSIAN_TOKEN is correct and that the Jira instance accepts token-based auth.
• If JQL searches are returning no results, check that the Jira user has access to the projects/issues being queried and that JQL syntax is correct.