dev5234/jira-mcp-server repository overview

⁠Jira MCP Server - AI Assistant Integration for Atlassian Jira

A comprehensive Python-based MCP (Model Context Protocol) server that enables AI assistants like Claude to interact seamlessly with Atlassian Jira. This enterprise-grade Docker image provides full-featured Jira integration with robust error handling and extensive tool coverage.

⁠🚀 Quick Start

⁠Pull and Run

bash docker run -d -p 8000:8000
-e ATLASSIAN_HOST=https://your-company.atlassian.net⁠
-e ATLASSIAN_EMAIL=[email protected]⁠
-e ATLASSIAN_TOKEN=your-api-token
devparihar5/jira-mcp-server:latest --http --port 8000

⁠Configure with Claude/Cursor

json { "mcpServers": { "jira": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-everything", "sse", "http://localhost:8000"] } } }

⁠✨ Key Features

⁠🎯 Core Issue Management

• Get detailed issue information with customizable fields and expansions
• Create new issues with full field support and validation
• Create child issues (subtasks) with automatic parent linking
• Update existing issues with partial field updates and conflict resolution
• Search issues using powerful JQL (Jira Query Language)
• Transition issues through workflow states with validation

⁠🔄 Advanced Operations

• Sprint management - Move issues to sprints, get active sprint info
• Issue linking - Create relationships between issues (blocks, duplicates, etc.)
• Comments & time tracking - Add comments and log work with flexible time formats
• Project management - List statuses, boards, and available transitions
• History tracking - Get detailed change logs and workflow transitions

⁠🏢 Enterprise Features

• Async/await architecture for high-performance operations
• Comprehensive error handling with detailed debugging information
• Multiple deployment modes - Stdio and HTTP server modes
• Docker containerization with security best practices
• Environment-based configuration with validation
• Bulk operations with progress tracking and error recovery

⁠🛠️ Available Tools (19 Total)

Issue Management: get_issue, create_issue, create_child_issue, update_issue, list_issue_types, transition_issue

Search & Query: search_issues

Sprint Management: list_sprints, get_sprint, get_active_sprint, move_issues_to_sprint

Project Tools: list_project_statuses, get_boards

Comments & Time: add_comment, get_comments, add_worklog

Relationships: link_issues, get_related_issues, get_issue_history

⁠🔧 Configuration

⁠Required Environment Variables

• ATLASSIAN_HOST - Your Jira instance URL (e.g., https://company.atlassian.net⁠)
• ATLASSIAN_EMAIL - Your Atlassian account email
• ATLASSIAN_TOKEN - Your Atlassian API token

⁠Get Your API Token

1. Go to Atlassian API Tokens⁠
2. Click "Create API token"
3. Copy the token (you won't see it again!)

⁠🐳 Usage Examples

⁠Stdio Mode (Default)

bash docker run --rm -i
-e ATLASSIAN_HOST=https://your-company.atlassian.net⁠
-e ATLASSIAN_EMAIL=[email protected]⁠
-e ATLASSIAN_TOKEN=your-api-token
devparihar5/jira-mcp-server:latest

⁠HTTP Server Mode

bash docker run -d -p 8000:8000
-e ATLASSIAN_HOST=https://your-company.atlassian.net⁠
-e ATLASSIAN_EMAIL=[email protected]⁠
-e ATLASSIAN_TOKEN=your-api-token
devparihar5/jira-mcp-server:latest --http --port 8000

⁠With move_issues_to_sprintEnvironment File

bash docker run -d -p 8000:8000
--env-file .env
devparihar5/jira-mcp-server:latest --http --port 8000

⁠💬 What You Can Ask Claude

Once configured, you can ask Claude to help with Jira tasks:

• "Create a new bug ticket for the login issue"
• "Show me details for ticket PROJ-123"
• "Move ticket PROJ-456 to In Progress"
• "What's in our current sprint?"
• "Show me all bugs created this week"
• "Add a comment to PROJ-789 saying the fix is ready"

⁠🔗 Links

• GitHub Repository: https://github.com/Devparihar5/Jira-MCP-Server.git⁠
• Documentation: Full setup and usage guide in the repository
• MCP Protocol: https://modelcontextprotocol.io/⁠

⁠🏷️ Tags

jira mcp ai-assistant claude atlassian python docker enterprise automation productivity

⁠📋 Requirements

• Docker
• Atlassian Jira account with API access
• AI assistant supporting MCP (Claude, Cursor, etc.)

⁠🤝 Contributing

Contributions welcome! Please visit the GitHub repository⁠ to report issues or submit pull requests.

⁠📄 License

MIT License - see the GitHub repository for details.