-
securityF
license-
qualityA Model Context Protocol server that integrates with Cursor IDE, providing real-time communication, modern web dashboards, and extensible tools via SSE and WebSocket connections.
Last updated -
595
1
Enables retrieving and searching JIRA issues using JQL (JIRA Query Language), with support for configurable field selection, pagination, and logging work on issues.
JIRA MCP Server
A simple Model Context Protocol (MCP) "vibe-coded" server for integrating JIRA with Cursor IDE. MCP is an open protocol that enables seamless integration between LLM applications and external data sources and tools.
This implementation started out by discarding another JIRA MCP server that we failed to init in Cursor.
BEWARE! Even this document is almost entirely written by AI coding assistant.
Features
Get JIRA issues by key
Search issues using JQL (JIRA Query Language)
Create and update issues (note: may have limitations with heavily customized JIRA projects)
Add comments to issues
Clone issues (useful for working around mandatory custom fields, but may have limitations with complex project configurations)
Configurable field selection
Pagination support
Detailed error handling and logging
Log work
User Workflows
Search and Filter Flow
graph LR
A[Start Search] -->|Enter JQL| B[Search Query]
B -->|Apply Filters| C[Results]
C -->|Select Fields| D[Customized View]
D -->|Pagination| E[More Results]
subgraph Search Options
F[JQL Query]
G[Field Selection]
H[Result Limit]
I[Start Position]
end
B -->|Uses| F
C -->|Uses| G
C -->|Uses| H
C -->|Uses| I
Issue Cloning Flow
graph LR
A[Find Source Issue] -->|Copy Key| B[Clone Issue]
B -->|Customize Fields| C[Modified Clone]
C -->|Create| D[New Issue]
subgraph Clone Options
E[Change Project]
F[Modify Fields]
G[Copy Attachments]
H[Add Source Link]
end
B -->|Can Use| E
B -->|Can Use| F
B -->|Can Use| G
B -->|Can Use| H
For detailed technical architecture and system workflows, including issue lifecycle and authentication flows, see ARCHITECTURE.md.
About MCP
This server implements the Model Context Protocol specification, allowing Cursor IDE to seamlessly interact with JIRA data through its AI features. The protocol standardizes how LLM applications communicate with external data sources and tools.
Setup
Create a virtual environment:
python -m venv venv
source venv/bin/activate # On Windows: venv\Scripts\activate
Install dependencies:
pip install -r requirements.txt
Configure environment variables: Create a
.envfile with:
JIRA_URL=your_jira_url
JIRA_USERNAME=your_username
JIRA_API_TOKEN=your_api_token
Usage
Run the server:
./run-jira-mcp.sh
Development
The project follows a modular structure:
src/
├── core/ # Core JIRA client implementation
│ ├── __init__.py
│ ├── client.py # JiraClient class
│ └── config.py # Configuration management
├── models/ # Pydantic models for validation
│ ├── __init__.py
│ ├── comment.py # Comment-related models
│ ├── issue.py # Issue-related models
│ └── worklog.py # Worklog-related models
└── operations/ # MCP operation implementations
├── __init__.py
├── comments.py # Comment operations
├── issues.py # Issue operations
├── projects.py # Project operations
└── worklog.py # Worklog operations
Key Components
Models (
src/models/)IssueType,IssueArgs- Issue creation/update modelsIssueTransitionArgs- Issue state transition modelCloneIssueArgs- Issue cloning modelCommentArgs,GetCommentsArgs- Comment modelsLogWorkArgs- Work logging model
Core (
src/core/)JiraClient- Main JIRA API clientJiraConfig- Configuration managementError handling and logging
Operations (
src/operations/)Issue management (get, search, create, update, clone)
Comment handling (add, get)
Work logging
Project listing
The project follows the implementation plan outlined in IMPLEMENTATION_PLAN.md.
Current version: v0.4
✅ Basic JIRA integration
✅ Search functionality with JQL support
✅ Issue management (create, update, clone) with limitations for heavily customized projects
✅ Comment functionality
✅ Work logging
Related Links
Model Context Protocol - The main MCP project
MCP Python SDK - The SDK we use to implement this server
MCP Documentation - Protocol documentation and specifications
License
MIT
Security Considerations
This tool is primarily designed for personal workflow automation and individual developer use. Please be aware of the following security considerations:
⚠️ Usage Recommendations
Personal/Development Use: Ideal for individual developers managing their JIRA workflows
Small Team Use: Suitable for trusted team environments with proper security measures
NOT Recommended For:
Production deployment in its current form
Multi-tenant environments
Public-facing services
Processing sensitive/regulated data
🔒 Security Requirements
If you choose to use this tool, please ensure:
Your JIRA instance uses HTTPS
You're using API tokens (not passwords) for authentication
Your
.envfile is properly secured and not committed to version controlYou understand the risks of running third-party tools with JIRA access
🛡️ Best Practices
Regularly rotate your API tokens
Monitor your JIRA audit logs for unexpected activity
Use the most recent version of the tool
Review the code before use in your environment
📝 Note on Enterprise Usage
This tool is not currently hardened for enterprise security requirements. If you need a solution for enterprise deployment, consider:
Implementing additional security controls
Conducting a security review
Contributing security improvements back to the project
Using official enterprise-grade alternatives
For security-related concerns or to report vulnerabilities, please open an issue or contact the maintainers directly.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A Model Context Protocol server that enables seamless integration between Cursor IDE and JIRA, allowing users to retrieve issues, execute JQL searches, and log work through natural language interactions.
Related MCP Servers
- -securityFlicense-qualityA Model Context Protocol server that enables AI assistants to explore and interact with Cursor IDE's SQLite databases, providing access to project data, chat history, and composer information.Last updated -21
- AsecurityFlicenseAqualityA Model Context Protocol server that enables integration with JIRA, allowing users to interact with JIRA tasks and issues through Claude AI assistant.Last updated -32
- AsecurityAlicenseAqualityA Model Context Protocol server that enables interaction with Jira's REST API using natural language commands, allowing users to manage Jira projects, issues, comments, and workflows through Claude Desktop and other MCP clients.Last updated -101MIT License