Script

🚀 Jira MCP (Model Control Protocol)

A Golang-based Jira MCP connector that enables AI assistants like Claude to interact with Atlassian Jira. This tool provides a seamless interface for AI models to perform common Jira operations.

🚀 Quick Start

Jira MCP is a powerful tool that allows AI models to interact with Atlassian Jira. Here's how you can get started with it.

✨ Features

• Retrieve detailed issue information.
• Create, update, and search for issues (including sub-issues).
• List all available issue types and statuses.
• Add and retrieve comments.
• Add work logs to issues.
• List and manage sprints.
• Retrieve issue history and relationships.
• Link issues and get related issues.
• Transition issues through workflows.

📦 Installation

Requirement: Golang 1.20+ (for building from source).

There are multiple ways to install Jira MCP:

Option 1: Download from GitHub Releases

1. Visit the GitHub Releases page.
2. Download the binary for your platform:
   • jira-mcp_linux_amd64 for Linux.
   • jira-mcp_darwin_amd64 for macOS.
   • jira-mcp_windows_amd64.exe for Windows.
3. For Linux/macOS, make the binary executable:

   chmod +x jira-mcp_*
   

4. Move it to your PATH directory (Linux/macOS):

   sudo mv jira-mcp_* /usr/local/bin/jira-mcp
   

Option 2: Install with Go

go install github.com/nguyenvanduocit/jira-mcp@latest

Option 3: Docker

Use Docker directly

1. Pull the pre-built image from the GitHub Container registry:

   docker pull ghcr.io/nguyenvanduocit/jira-mcp:latest
   

2. Or build the Docker image locally:

   docker build -t jira-mcp .
   

📚 Documentation

Configuration

Environment Variables

The following environment variables are used for authentication and are required:

ATLASSIAN_HOST=your_atlassian_host
ATLASSIAN_EMAIL=your_email
ATLASSIAN_TOKEN=your_token

You can set them in the following ways:

1. Directly in the Docker run command (recommended).
2. Through a .env file (optional, only for local development, use the -env flag).
3. Directly in your shell environment variables.

Using with Claude and Cursor

To make Jira MCP work with Claude and Cursor, you need to add the configuration to the Cursor settings.

Step 1: Install Jira MCP

Choose any of the installation methods mentioned above (Docker is recommended).

Step 2: Configure Cursor

1. Open Cursor.
2. Go to Settings > MCP > Add MCP Server.
3. Add the following configuration:

Option A: Use Docker (Recommended)

{
  "mcp": {
    "servers": [
      {
        "name": "Jira Docker",
        "type": "docker",
        "command": "jira-mcp",
        "args": [
          "--host ${ATLASSIAN_HOST}",
          "--email ${ATLASSIAN_EMAIL}",
          "--token ${ATLASSIAN_TOKEN}"
        ]
      }
    ]
  }
}

Option B: Use Local Binary

{
  "mcp": {
    "servers": [
      {
        "name": "Jira Local",
        "type": "local-binary",
        "path": "/usr/local/bin/jira-mcp",
        "args": [
          "--host ${ATLASSIAN_HOST}",
          "--email ${ATLASSIAN_EMAIL}",
          "--token ${ATLASSIAN_TOKEN}"
        ]
      }
    ]
  }
}

Step 3: Use Claude

Now, you can call Jira MCP through Claude. For example:

claude --mcp "jira" --command "search-issues" --arg "query:My Project"

🤝 Contribution Guidelines

To contribute to the project, visit the GitHub repository and follow the contribution guidelines.

📄 License

This project is licensed under the MIT License.