@atlassian-dc-mcp/jira

Atlassian Jira Data Center MCP

This package provides a Machine Comprehension Protocol (MCP) server for interacting with Atlassian Jira Data Center edition.

Claude Desktop Configuration

To use this MCP connector with Claude Desktop, add the following to your Claude Desktop configuration:

macOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "atlassian-jira-dc": {
      "command": "npx",
      "args": ["-y", "@atlassian-dc-mcp/jira"],
      "env": {
        "JIRA_HOST": "your-jira-host",
        "JIRA_API_TOKEN": "your-token"
      }
    }
  }
}

Note: Set JIRA_HOST variable only to domain + port without protocol (e.g., your-instance.atlassian.net). The https protocol is assumed.

Features

• Search for issues using JQL (Jira Query Language)
• Get issue details by key
• Get issue comments
• Create and update issues
• Add comments to issues

Setup

1. Install dependencies:

   npm install
   

2. Create a .env file in the packages/jira directory with the following variables:

   JIRA_HOST=your-jira-instance.atlassian.net
   JIRA_API_TOKEN=your-personal-access-token
   

   To create a personal access token:

   • In Jira, select your profile picture at the top right
   • Select Personal Access Tokens
   • Select Create token and give it a name
   • Copy the token and store it securely (you won't be able to see it again)

Usage

Start the MCP server:

npm run build

Or for development with auto-reload:

npm run dev

Available Tools

1. jira_searchIssues

Search for JIRA issues using JQL in the JIRA Data Center edition instance.

Parameters:

• jql (string, required): JIRA Query Language search string
• expand (array, optional): Fields to expand in the response
• startAt (number, optional): Starting index for pagination
• maxResults (number, optional): Maximum number of results to return (default: 10)

2. jira_getIssue

Get details of a JIRA issue by its key from the JIRA Data Center edition instance.

Parameters:

• issueKey (string, required): The issue key (e.g., "PROJECT-123")
• expand (string, optional): Comma-separated list of fields to expand

3. jira_getIssueComments

Get comments for a JIRA issue from the JIRA Data Center edition instance.

Parameters:

• issueKey (string, required): The issue key (e.g., "PROJECT-123")
• expand (string, optional): Comma-separated list of fields to expand

4. jira_createIssue

Create a new issue in the JIRA Data Center edition instance.

Parameters:

• projectId (string, required): ID of the project
• summary (string, required): Issue summary
• description (string, required): Issue description in format suitable for JIRA Data Center edition (JIRA Wiki Markup)
• issueTypeId (string, required): ID of the issue type

5. jira_postIssueComment

Add a comment to a JIRA issue in the JIRA Data Center edition instance.

Parameters:

• issueKey (string, required): The issue key (e.g., "PROJECT-123")
• comment (string, required): Comment text in format suitable for JIRA Data Center edition (JIRA Wiki Markup)