jira-mcp

jira-mcp

19
communication

JIRA MCP Server is a Model Context Protocol (MCP) server designed to interact smoothly with JIRA Cloud and Server, offering facilities like issue management, epic tracking, and content optimization for AI. It provides a robust solution for handling JIRA data with advanced error management and API request efficiency.

JIRA MCP Server

A Model Context Protocol (MCP) server implementation providing access to JIRA data with features like relationship tracking, optimized data payloads, and data cleaning for AI context windows. It supports both Jira Cloud and Jira Server (Data Center). Key features include searching JIRA issues, retrieving epic children, getting detailed issue information, creating and updating issues, and more.

Features

  • Search JIRA issues using JQL
  • Retrieve epic children with comments
  • Create, update, and manage JIRA issues
  • Add comments and attachments
  • Track issue relationships
  • Clean and transform content for AI efficiency

Prerequisites

  • Bun (v1.0.0 or higher)
  • JIRA account with API access

Installation & Setup

  1. Clone the repository and install dependencies.
  2. Configure the MCP server files according to your OS.
  3. Restart the MCP server to apply changes.

Development

  • Run tests with bun test
  • Use bun run dev for development watch mode
  • Rebuild after changes with bun run build

Technical Details

  • Built with TypeScript and Bun runtime
  • Uses JIRA REST API v3
  • Offers optimized API request handling and error management

Error Handling

Includes comprehensive error management for network issues, API errors, and rate limiting.