MCP 服务器

copilot-jira-mcp

MCP server for seamless Jira integration with GitHub Copilot CLI, allowing natural language queries to search, view, and manage Jira tickets.

README

🎫 Copilot Jira MCP Server

Official MCP (Model Context Protocol) server for seamless Jira integration with GitHub Copilot CLI

Interact with Jira issues, search tickets, and manage your workflow directly from GitHub Copilot CLI using natural language!

✨ Features

🔍 Smart Search - Search Jira tickets using JQL or natural language
📝 Issue Details - Get comprehensive information about any ticket
💬 Comments - Read and analyze issue comments
🔗 Subtasks & Links - Navigate issue hierarchies
📎 Attachments - List and access issue attachments
👤 My Issues - Quick access to your assigned tickets
🚀 Fast & Lightweight - Minimal dependencies, maximum performance
🔐 Secure - Credentials stored safely in environment variables
🌍 Universal - Works with any Jira instance (Cloud or Server)
🎯 AI-Powered - Let Copilot understand and query your Jira naturally

🚀 Quick Start

Prerequisites

Node.js 18 or higher (Download)
GitHub Copilot CLI (Setup Guide)
Jira Account with API access

Installation

Option 1: Install from GitHub (Recommended) ⭐

# Install globally from GitHub
npm install -g git+https://github.com/GiDanis/copilot-jira-mcp.git

# Run interactive setup
npx jira-mcp setup

Option 2: Clone and Install

# Clone repository
git clone https://github.com/GiDanis/copilot-jira-mcp.git
cd copilot-jira-mcp

# Install dependencies
npm install

# Run setup wizard
npm run setup

# Register with Copilot
npm run register

Option 3: NPM Package

# Install from NPM
npm install -g copilot-jira-mcp

Configuration

The setup wizard will guide you through:

Jira URL - Your Jira instance URL (e.g., https://your-company.atlassian.net)
Email - Your Jira account email
API Token - Generate at Atlassian API Tokens

Credentials are stored securely in environment variables:

JIRA_URL
JIRA_EMAIL
JIRA_API_TOKEN

📖 Usage

Once installed, simply open Copilot and use natural language:

copilot

Example Queries

Get your tickets:

> Show me my assigned Jira tickets

Search issues:

> Search Jira for open bugs in project IIAB
> Find all high priority tickets in sprint 23
> Show me tickets updated in the last week

Get ticket details:

> Get details for IIAB-12345
> Show me comments on ticket PROJ-789
> List subtasks for IIAB-456

Advanced JQL:

> Search Jira with JQL: project = IIAB AND status = "In Progress"

🛠️ Available Tools

The MCP server exposes these tools to Copilot:

Tool	Description
`jira_search`	Search issues using JQL
`jira_get_issue`	Get detailed ticket information
`jira_get_comments`	Retrieve all comments
`jira_get_subtasks`	List all subtasks
`jira_get_attachments`	List attachments
`jira_get_my_issues`	Get your assigned tickets

🔐 Security

Your credentials are NEVER committed or shared!

✅ Stored in environment variables
✅ .gitignore prevents accidental commits
✅ No plaintext storage
✅ API tokens can be revoked anytime

Best Practices:

Generate dedicated API tokens (don't reuse)
Revoke tokens when not needed
Never share .env files
Use different tokens for different machines

See SECURITY.md for complete security guidelines.

📚 Documentation

Installation Guide - Detailed setup instructions
Configuration - Advanced configuration options
Usage Examples - More query examples
Troubleshooting - Common issues and solutions
Contributing - How to contribute

🔧 Manual Configuration

If you prefer manual setup:

Windows (PowerShell)

# Set environment variables
[Environment]::SetEnvironmentVariable("JIRA_URL", "https://your-company.atlassian.net", "User")
[Environment]::SetEnvironmentVariable("JIRA_EMAIL", "your.email@company.com", "User")
[Environment]::SetEnvironmentVariable("JIRA_API_TOKEN", "your-token-here", "User")

# Restart terminal

Mac/Linux (Bash/Zsh)

# Add to ~/.bashrc or ~/.zshrc
export JIRA_URL="https://your-company.atlassian.net"
export JIRA_EMAIL="your.email@company.com"
export JIRA_API_TOKEN="your-token-here"

# Reload shell
source ~/.bashrc  # or ~/.zshrc

Register MCP Server

Edit ~/.copilot/mcp.json:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/copilot-jira-mcp/src/index.js"],
      "env": {
        "JIRA_URL": "${JIRA_URL}",
        "JIRA_EMAIL": "${JIRA_EMAIL}",
        "JIRA_API_TOKEN": "${JIRA_API_TOKEN}"
      }
    }
  }
}