Jira Context MCP

A Model Context Protocol (MCP) implementation for Jira that allows you to:

• Input a Jira ticket link to fetch issue details and instruct Cursor to fix it
• Retrieve all tickets assigned to you within a specified Jira project
• Filter Jira issues based on a specific issue type and automatically direct Cursor to resolve them
• Integrate seamlessly with Jira's API for automation and efficiency

Setup

Prerequisites

• Node.js 20.17.0 or higher
• A Jira account with API access
• A Jira API token (can be generated at Atlassian API Tokens)

Installation

Installing via Smithery

To install Jira Context MCP for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @rahulthedevil/Jira-Context-MCP --client claude

Installing manually

1. Clone this repository:

git clone https://github.com/yourusername/Jira-Context-MCP.git
   cd Jira-Context-MCP

2. Install dependencies:

npm install
   # or if you use pnpm
   pnpm install

3. Create a .env file based on the example:

cp .env.example .env

4. Edit the .env file with your Jira details:

JIRA_BASE_URL=https://your-domain.atlassian.net
   JIRA_USERNAME=your-email@example.com
   JIRA_API_TOKEN=your-api-token-here
   HTTP_PORT=3000

Build

Build the project with:

npm run build
# or
pnpm build

Usage

Starting the Server

Start the HTTP server:

npm start
# or
pnpm start

Or use the CLI mode:

npm run start:cli
# or
pnpm start:cli

Connecting with Cursor

1. In Cursor, open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P)

2. Type "Connect to MCP Server"

3. Select "Connect to MCP Server"

4. Enter the server URL (default: http://localhost:3000/sse)

Available Tools

Once connected, you can use the following tools in Cursor:

1. Get Jira Issue Details

Fetch detailed information about a specific Jira issue:

/get_issue issueKey:PROJECT-123

2. Get Assigned Issues

Retrieve issues assigned to you in a specific project:

/get_assigned_issues projectKey:PROJECT maxResults:10

3. Get Issues by Type

Filter issues by type (Bug, Story, Epic, etc.):

/get_issues_by_type issueType:Bug projectKey:PROJECT maxResults:10

4. Get Projects

List all available projects:

/get_projects

5. Get Issue Types

List all available issue types:

/get_issue_types

6. Get Recent Ticket Changes

Retrieve changes made in tickets over a specified period (e.g., the last 7 days) in a project:

/get_recent_changes projectKey:PROJECT maxDays:7

Command Examples

🚀 Jira MCP Server + Cursor IDE = Your AI-powered Jira assistant! Here’s how it makes devs work smarter:

📂 "List all Jira projects I have access to"

→ AI fetches all available projects instantly

No more searching manually!

📋 "List all issues in PROJECT"

→ AI retrieves all open tickets

Stay organized without effort!

🐛 "Filter only Bugs or Change Requests and fix them"

→ AI identifies & directs Cursor to resolve them

Fix issues faster with automation!

✅ "Find all tickets assigned to me and fix them"

→ AI pulls your tasks & lets Cursor handle them

Stay on top of your work with zero hassle!

🔍 "Get details for Jira issue PROJECT-123"

→ AI fetches full issue info in seconds

No more switching tabs!

📊 "What changed in tickets in the last 7 days in PROJECT?"

→ AI tracks recent updates & highlights key changes

No more manually checking ticket histories!

🔥 TL;DR: Your AI now speaks Jira + Cursor! Fetch projects, filter issues, track changes & fix bugs—all inside your IDE.

From backlog to bug fixes, MCP Server makes Jira work for you!

Example Workflows

Fix a Specific Bug

1. Connect to the Jira MCP server in Cursor.

2. Get the issue details:

/get_issue issueKey:PROJECT-123

3. Review the issue details and instruct Cursor to fix it:

Fix the bug described in PROJECT-123

Work on Your Assigned Issues

1. Connect to the Jira MCP server in Cursor.

2. Retrieve your assigned issues:

/get_assigned_issues projectKey:PROJECT

3. Ask Cursor to help with one of the issues:

Help me solve the first issue in my assigned list

Fix All Bugs in a Project

1. Connect to the Jira MCP server in Cursor.

2. Retrieve all bug issues:

/get_issues_by_type issueType:Bug projectKey:PROJECT

3. Instruct Cursor:

Help me fix these bugs one by one

Review Recent Changes

1. Connect to the Jira MCP server in Cursor.

2. Retrieve recent ticket updates:

/get_recent_changes projectKey:PROJECT maxDays:7

3. Review the changes to stay updated on modifications.

Development

Project Structure

• src/ - Source code
• services/ - Jira API service
• types/ - TypeScript type definitions
• utils/ - Utility functions
• server.ts - MCP server implementation
• index.ts - Application entry point
• cli.ts - CLI entry point

Adding New Tools

To add new tools, edit the src/server.ts file and add new tool definitions in the registerTools method.

License

MIT

Author

Rahul Dey - @rahulthedevil