JIRA MCP Server

A TypeScript implementation of a JIRA MCP Server: Essential API Integrations for Technical Program Managers and Engineers

Features

• JQL search functionality
• Issue retrieval by ID or key
• Seamless integration with the Model Context Protocol

Quick Start

Install and run the server using npx:

npx @rujutaranade/likejarvis-jira-mcp-server
npm i likejarvis-jira-mcp-server

Prerequisites

• Node.js (v18 or higher)
• A JIRA instance with API access
• JIRA API key/token

Setup

1. Clone this repository
2. Install dependencies:

   npm install
   

3. Copy the environment file example and fill in your JIRA credentials:

   cp .env.example .env
   

4. Edit the .env file with your JIRA instance URL, API key, and user email

Building and Running

Build the TypeScript code:

npm run build

Start the server:

npm start

For development with auto-reload:

npm run dev

Available Tools

1. JQL Search (jql_search)

Perform enhanced JQL (JIRA Query Language) searches to find issues.

Parameters:

• jql (required): The JQL query string
• nextPageToken: Token for pagination
• maxResults: Maximum number of results to return (default: 50)
• fields: List of fields to include in the response
• expand: Additional information to include in the response

2. Get Issue (get_issue)

Retrieve detailed information about a specific issue.

Parameters:

• issueIdOrKey (required): ID or key of the issue
• fields: Fields to include in the response
• expand: Additional information to include in the response
• properties: Properties to include in the response
• failFast: Whether to fail quickly on errors (default: false)

Environment Variables

• JIRA_INSTANCE_URL: The URL of your JIRA instance
• JIRA_API_KEY: Your JIRA API key/token
• JIRA_USER_EMAIL: The email associated with your JIRA account

License

MIT