Skip to content

phuc-nt/jira-cloud-mcp-server

Repository files navigation

MCP Jira Server

AI meets Jira - Connect AI assistants to your Jira workspace with modular architecture and enhanced compatibility

Jira Logo

Tools Modules License Status

🚀 What is this?

MCP Jira Server enables AI assistants like Claude, Cline, Cursor, and other MCP-compatible tools to interact with Atlassian Jira using API token authentication - featuring modular architecture, enhanced AI client compatibility, and enterprise-ready performance. Choose only the modules you need for optimized memory usage.

✨ Features

🔧 46 Optimized Tools Across 4 Modules:

  • Core Module (14): Essential CRUD operations, user management, project operations
  • Agile Module (10): Sprint & board management, workflow operations
  • Dashboard Module (8): Analytics, reporting, dashboard management
  • Search Module (14): Enhanced search & Epic discovery, universal user search

🎯 Key Capabilities:

  • Modern JQL API - Enhanced search with full issue data retrieval (no IDs-only limitation)
  • Modular Architecture - Up to 64% memory reduction with selective loading
  • Enhanced AI Client Compatibility - Comprehensive usage patterns & error prevention
  • Production Ready - 100% test success rate across all 46 tools

🚀 Quick Start

📦 Install from NPM (Recommended)

npm install -g mcp-jira-cloud-server

📖 Complete Installation Guide - Follow the step-by-step setup guide

Architecture

Module Distribution (46 Total Tools - Optimized)

Module Tools Success Rate Use Case
Core 14 100% Essential CRUD operations
Agile 10 100% Sprint & workflow management
Dashboard 8 100% Analytics & reporting
Search 14 100% Enhanced search & Epic discovery

Configuration Options

4 Deployment Options:

  • Essential Stack (28 tools): Core + Search modules
  • Complete Agile (38 tools): Core + Agile + Search modules
  • Analytics Focus (22 tools): Search + Dashboard modules
  • Legacy Compatibility (46 tools): All modules in single server

📖 Complete Configuration Guide - Detailed setup instructions with working configs

💡 Usage Examples

Create Issues with Natural Language:

Human: Create a new Epic called "User Authentication System" in the DEMO project

AI Assistant: I'll create that Epic for you using the createIssue tool:
□ Project: DEMO
□ Issue Type: Epic (auto-detected)
□ Summary: "User Authentication System"
□ Creating issue now...

✅ Created Epic DEMO-142: "User Authentication System"

Advanced Search & Analysis:

Human: Find all high-priority bugs assigned to me that were created last week

AI Assistant: I'll search for your high-priority bugs from last week:
□ Use enhancedSearchIssues with modern JQL API: "assignee = currentUser() AND priority = High AND issueType = Bug AND created >= -7d"
□ Enhanced API returns full issue details (no IDs-only limitation)
□ Found 3 matching issues with complete data in single API call
□ Analyzing priority, status, and resolution timeframes...

Found 3 high-priority bugs: DEMO-140, DEMO-138, DEMO-135 - details attached.

Sprint Management & Agile Workflows:

Human: Show me the current sprint status and add issue DEMO-123 to the active sprint

AI Assistant: I'll check your sprint status and add the issue:
□ Use listSprints to find active sprint for your board
□ Use getSprintIssues to see current sprint contents  
□ Use addIssueToSprint to add DEMO-123
□ Provide sprint summary with updated issue count

Current Sprint "Sprint 24" has 12 issues, adding DEMO-123 now... ✅ Added successfully!

🛠️ Tech Stack

  • TypeScript - Type-safe development with strict mode
  • Node.js - Runtime environment (16.x+)
  • MCP Protocol - Model Context Protocol for AI integration
  • Jira APIs - Native Jira Platform API v3 + Agile API v1.0
  • Modular Architecture - Specialized modules for optimized performance

📄 License

MIT License - see LICENSE for details.


🎉 Connect your AI assistant to Jira with modular architecture and enhanced compatibility!

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •