Jira Data Center MCP Server

Jira Data Center MCP Server

Model Context Protocol (MCP) server for Atlassian Jira Data Center with semantic search and AI-powered workflow automation.

Transform natural language queries into precise Jira API operations. Built for LLMs (Claude, GPT-4, and other MCP-compatible clients) to interact intelligently with Jira Data Center through production-ready semantic search and operation execution.

Why This Exists

Working with Jira's REST API requires knowing exact endpoint names, HTTP methods, and complex JSON schemas. This MCP server solves that problem:

• Semantic Search: Ask "create an issue" → get ranked Jira operations with >90% relevance
• Zero-Config Setup: Interactive 5-minute wizard handles authentication, credentials, and database setup
• Production-Ready: Circuit breakers, rate limiting, retry logic, and secure credential storage (OS keychains)
• Multi-Auth Support: OAuth 2.0, Personal Access Tokens, OAuth 1.0a, or Basic Auth
• Security-First: Automatic data sanitization in logs, sensitive information redaction, and structured logging

Perfect for teams building AI assistants, automation workflows, or LLM integrations with Jira Data Center.

Key Features

✅ Semantic Search Engine - Find Jira operations using natural language with >90% relevance (sqlite-vec embeddings)
✅ Three MCP Tools - search_ids, get_id, call_id for discovery, inspection, and execution
✅ Multi-Authentication - OAuth 2.0, Personal Access Tokens, OAuth 1.0a, Basic Auth with secure OS keychain storage
✅ Production Resilience - Circuit breaker pattern, rate limiting, exponential backoff, automatic retries
✅ Zero-Config Setup - Interactive CLI wizard completes full setup in <5 minutes
✅ Structured Logging - JSON logs with correlation IDs, automatic credential redaction, ELK/Datadog ready
✅ Air-Gapped Support - Local embeddings generation, no external API dependencies
✅ Cross-Platform - Linux, macOS, Windows with Node.js 22+

Quick Start

Get up and running in under 5 minutes using Docker, npm, or source installation.

Docker (Recommended)

Fastest path - One command to start the MCP server:

# Pull and run the official image
docker run -it \
  -e JIRA_URL=https://jira.example.com \
  -e JIRA_AUTH_METHOD=pat \
  -e JIRA_TOKEN=your-personal-access-token \
  ghcr.io/guercheLE/jira-dc-mcp:latest

Or use docker-compose for persistent configuration:

# Clone the repo
git clone https://github.com/guercheLE/jira-dc-mcp.git
cd jira-datacenter-mcp-server

# Configure environment variables in docker-compose.yml
# Start the server
docker-compose up -d

Expected Output:

✅ MCP Server started successfully
🔍 Semantic search ready (500+ Jira operations indexed)
🔐 Authentication configured: Personal Access Token
📡 Listening on stdio transport

Troubleshooting: If you see connection errors, verify your JIRA_URL and credentials. See Docker Guide for advanced configuration.

npm Install

Recommended for local development - Global CLI with interactive setup:

# Install globally
npm install -g jira-dc-mcp

# Run setup wizard (interactive prompts)
jira-dc-mcp setup

# Start the MCP server
jira-dc-mcp start

The setup wizard will: 1