MCP 服务器

MCP Jira Server

Enables AI assistants to interact with Atlassian Jira via API token authentication, with 46 optimized tools across modular architecture for CRUD, agile, dashboard, and search operations.

README

MCP Jira Server

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

🚀 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!