MCP server to provide Jira Tickets information to AI coding agents like Cursor
x000D
x000D
x000D x000D A Model Context Protocol (MCP) implementation for Jira that allows you to:x000D x000D - Input a Jira ticket link to fetch issue details and instruct Cursor to fix it_x000D_ - Retrieve all tickets assigned to you within a specified Jira project x000D - Filter Jira issues based on a specific issue type and automatically direct Cursor to resolve them_x000D_ - Integrate seamlessly with Jira's API for automation and efficiency_x000D_ x000D
x000D
x000D - Node.js 20.17.0 or higher_x000D_ - A Jira account with API access_x000D_ - A Jira API token (can be generated at Atlassian API Tokens)x000D x000D
x000D
x000D
To install Jira Context MCP for Claude Desktop automatically via Smithery:x000D
x000D
bash_x000D_
npx -y @smithery/cli install @rahulthedevil/Jira-Context-MCP --client claude_x000D_x000D
x000D
x000D
1. Clone this repository:x000D
bash_x000D_
git clone https://github.com/yourusername/Jira-Context-MCP.git_x000D_
cd Jira-Context-MCP_x000D_x000D
x000D
2. Install dependencies:x000D
bash_x000D_
npm install_x000D_
# or if you use pnpm_x000D_
pnpm install_x000D_x000D
x000D
3. Create a .env file based on the example:x000D
bash_x000D_
cp .env.example .env_x000D_x000D
x000D
4. Edit the .env file with your Jira details:x000D
_x000D_
JIRA_BASE_URL=https://your-domain.atlassian.net_x000D_
[email protected]_x000D_
JIRA_API_TOKEN=your-api-token-here_x000D_
HTTP_PORT=3000_x000D_x000D
x000D
x000D Build the project with:x000D x000D ```bash_x000D_ npm run build_x000D_
pnpm build_x000D_ ```x000D x000D
x000D
x000D Start the HTTP server:x000D x000D ```bash_x000D_ npm start_x000D_
pnpm start_x000D_
_x000D_
_x000D_
Or use the CLI mode:_x000D_
_x000D_bash_x000D_
npm run start:cli_x000D_
pnpm start:cli_x000D_ ```x000D x000D
x000D
1. In Cursor, open the Command Palette (Ctrl+Shift+P or Cmd+Shift+P)x000D
2. Type "Connect to MCP Server"x000D
3. Select "Connect to MCP Server"x000D
4. Enter the server URL (default: http://localhost:3000/sse)x000D
x000D
x000D Once connected, you can use the following tools in Cursor:x000D x000D
x000D
Fetch detailed information about a specific Jira issue:x000D
_x000D_
/get_issue issueKey:PROJECT-123_x000D_x000D
x000D
x000D
Retrieve issues assigned to you in a specific project:x000D
_x000D_
/get_assigned_issues projectKey:PROJECT maxResults:10_x000D_x000D
x000D
x000D
Filter issues by type (Bug, Story, Epic, etc.):x000D
_x000D_
/get_issues_by_type issueType:Bug projectKey:PROJECT maxResults:10_x000D_x000D
x000D
x000D
List all available projects:x000D
_x000D_
/get_projects_x000D_x000D
x000D
x000D
List all available issue types:x000D
_x000D_
/get_issue_types_x000D_x000D
x000D
x000D
Retrieve changes made in tickets over a specified period (e.g., the last 7 days) in a project:x000D
_x000D_
/get_recent_changes projectKey:PROJECT maxDays:7_x000D_x000D
x000D
x000D ? Jira MCP Server + Cursor IDE = Your AI-powered Jira assistant! Here’s how it makes devs work smarter:x000D x000D ? "List all Jira projects I have access to" x000D → AI fetches all available projects instantly x000D No more searching manually!x000D x000D ? "List all issues in PROJECT" x000D → AI retrieves all open tickets x000D Stay organized without effort!x000D x000D ? "Filter only Bugs or Change Requests and fix them" x000D → AI identifies & directs Cursor to resolve them x000D Fix issues faster with automation!x000D x000D ✅ "Find all tickets assigned to me and fix them" x000D → AI pulls your tasks & lets Cursor handle them x000D Stay on top of your work with zero hassle!x000D x000D ? "Get details for Jira issue PROJECT-123" x000D → AI fetches full issue info in seconds x000D No more switching tabs!x000D x000D ? "What changed in tickets in the last 7 days in PROJECT?" x000D → AI tracks recent updates & highlights key changes x000D No more manually checking ticket histories!x000D x000D ? TL;DR: Your AI now speaks Jira + Cursor! Fetch projects, filter issues, track changes & fix bugs—all inside your IDE. x000D From backlog to bug fixes, MCP Server makes Jira work for you!x000D x000D
x000D
x000D
1. Connect to the Jira MCP server in Cursor.x000D
2. Get the issue details:x000D
_x000D_
/get_issue issueKey:PROJECT-123_x000D_x000D
3. Review the issue details and instruct Cursor to fix it:x000D
_x000D_
Fix the bug described in PROJECT-123_x000D_x000D
x000D
x000D
1. Connect to the Jira MCP server in Cursor.x000D
2. Retrieve your assigned issues:x000D
_x000D_
/get_assigned_issues projectKey:PROJECT_x000D_x000D
3. Ask Cursor to help with one of the issues:x000D
_x000D_
Help me solve the first issue in my assigned list_x000D_x000D
x000D
x000D
1. Connect to the Jira MCP server in Cursor.x000D
2. Retrieve all bug issues:x000D
_x000D_
/get_issues_by_type issueType:Bug projectKey:PROJECT_x000D_x000D
3. Instruct Cursor:x000D
_x000D_
Help me fix these bugs one by one_x000D_x000D
x000D
x000D
1. Connect to the Jira MCP server in Cursor.x000D
2. Retrieve recent ticket updates:x000D
_x000D_
/get_recent_changes projectKey:PROJECT maxDays:7_x000D_x000D
3. Review the changes to stay updated on modifications.x000D
x000D
x000D
x000D
- src/ - Source code_x000D_
- services/ - Jira API service_x000D_
- types/ - TypeScript type definitions_x000D_
- utils/ - Utility functions_x000D_
- server.ts - MCP server implementation_x000D_
- index.ts - Application entry point_x000D_
- cli.ts - CLI entry point_x000D_
x000D
x000D
To add new tools, edit the src/server.ts file and add new tool definitions in the registerTools method.x000D
x000D
x000D MIT_x000D_ x000D
x000D Rahul Dey - @rahulthedevilx000D