Introduction

This repository provides a Model Context Provider (MCP) server that integrates Jira tickets with GitHub Copilot Chat. It fetches relevant information from Jira to enhance the context for AI-driven code suggestions.

Features

• Fetches Jira ticket details based on the provided ticket ID.
• Fetches any linked Jira tickets
• Provides ticket type, summary, description, and components of the Jira ticket.

Setup

For Local Development

1. Clone the repository:

   git clone https://github.com/amattu2/jira-mcp-server.git
   cd jira-mcp-server
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

4. Setup the VSCode MCP (.vscode/mcp.json):

   {
     "servers": {
       "jira-ticket-mcp": {
         "type": "stdio",
         "command": "node",
         "args": [
           "path_to_the_project/build/index.js"
         ],
         "env": {
           "JIRA_API_TOKEN": "${input:jira-api-token}",
           "JIRA_BASE_URL": "${input:jira-base-url}"
         }
       }
     },
     "inputs": [
       {
         "type": "promptString",
         "id": "jira-api-token",
         "description": "The Jira API token to use for authentication",
         "password": true
       },
       {
         "type": "promptString",
         "id": "jira-base-url",
         "description": "The base URL of the Jira instance (e.g. https://example.com)",
         "password": false
       }
     ]
   }
   

For GitHub MCP (Copilot Coding Agent)

1. Navigate to Repository Settings

2. Find Copilot > Coding agent

3. MCP Configuration

4. Add a new MCP configuration with the following details:

    {
      "mcpServers": {
        "jira": {
          "type": "local",
          "command": "npx",
          "args": [
            "jira-cloud-mcp-server@latest"
          ],
          "env": {
            "JIRA_API_TOKEN": "COPILOT_MCP_JIRA_API_TOKEN",
            "JIRA_BASE_URL": "COPILOT_MCP_JIRA_BASE_URL"
          },
          "tools": ["*"]
        }
      } 
    }
   

5. Add the COPILOT_MCP_JIRA_API_TOKEN and COPILOT_MCP_JIRA_BASE_URL secrets to your repository under Environments Secrets > copilot environment.