# 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:

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

2. Install dependencies:

    ```bash
    npm install
    ```

3. Build the project:

    ```bash
    npm run build
    ```

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

    ```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:

   ```json
    {
      "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.