Comprehensive MCP server for Jira integration with Claude Code
概览
A comprehensive Model Context Protocol (MCP) server for Jira integration with Claude Code. This server provides complete Jira functionality including issue management, sprint operations, comments, attachments, and batch processing. ⚠️ : Never commit your API tokens! All credentials should be in .env files or environment variables. - - Create issues with full field support including custom fields and dates - - Update existing issues with smart field handling - - Retrieve detailed issue information - - Advanced search using JQL or simplified filters with date support - - Move issues through workflow states - - Create relationships between issues (with smart type matching) - - List available issue link types - - Show available fields for project/issue type - - Troubleshoot field configuration and find custom field IDs - - Create epic with multiple subtasks in one operation - - Create task linked to epic (optimized for localized Jira) - - Read issue comments with author and timestamp...
README
以下为原文 README 节选，完整内容请查看原文。
MCP Jira Server fo Claude Code
A comprehensive Model Context Protocol (MCP) server for Jira integration with Claude Code. This server provides complete Jira functionality including issue management, sprint operations, comments, attachments, and batch processing.
⚠️ Security Note: Never commit your API tokens! All credentials should be in .env files or environment variables.
🚀 Features
📋 Issue Management (12 tools)
- create-issue - Create issues with full field support including custom fields and dates
- update-issue - Update existing issues with smart field handling
- get-issue - Retrieve detailed issue information
- search-issues - Advanced search using JQL or simplified filters with date support
- transition-issue - Move issues through workflow states
- link-issues - Create relationships between issues (with smart type matching)
- get-link-types - List available issue link types
- get-fields - Show available fields for project/issue type
- diagnose-fields - Troubleshoot field configuration and find custom field IDs
- create-epic-with-subtasks - Create epic with multiple subtasks in one operation
- create-task-for-epic - Create task linked to epic (optimized for localized Jira)
💬 Comments & History (3 tools)
- get-comments - Read issue comments with author and timestamp information
- get-history - View detailed change history with field modifications
- add-comment - Add comments with Atlassian Document Format support
- batch-comment - Add same comment to multiple issues simultaneously
📎 Attachments (2 tools)
- get-attachments - List attachments with metadata (size, type, upload date)
- upload-attachment - Upload files using base64 encoding
🏃 Sprint & Agile Management (4 tools)
- get-boards - List available Jira boards for agile projects
- get-sprints - View sprints for a board with status indicators
- move-issue-to-sprint - Move issues between sprints and backlog
- create-sprint - Create new sprints with optional start/end dates
Resources
jira://projects- List all accessible projectsjira://project/{key}- Get specific project detailsjira://issue/{key}- Get specific issue detailsjira://myself- Current user informationjira://search?jql={query}- Search results
Prompts
- standup-report - Generate daily standup reports
- sprint-planning - Assist with sprint planning activities
- bug-triage - Help prioritize and triage bugs
- release-notes - Generate release notes from completed issues
- epic-status - Comprehensive epic progress reports
Installation
- Clone the repository:
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手？先看 mcpskill.org 教程 →配置
{
"mcpServers": [
{
"name": "jira",
"command": "node",
"args": ["/absolute/path/to/mcp-jira-server/dist/index.js"],
"env": {
"JIRA_HOST": "https://your-company.atlassian.net",
"JIRA_EMAIL": "[email protected]",
"JIRA_API_TOKEN": "your-api-token",
"JIRA_DEFAULT_PROJECT": "PROJ"
}
}
]
}