Jira MCP服务器
MCP服务器，用于从Claude Code或任何兼容MCP的客户端与Jira Cloud进行交互。
设置
npm install
npm run build创建 .env 从示例中可以看出：
JIRA_URL=https://your-domain.atlassian.net
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=在以下位置获取API令牌：https://id.atlassian.com/manage-profile/security/api-tokens
连接到克劳德代码
claude mcp add jira node /path/to/jira-mcp-api/dist/index.js添加后重新启动Claude Code——工具将自动可用。
工具
问题
| 工具 | 说明 |
|---|---|
jira_search | 通过JQL搜索问题(jql, maxResults?, fields?) |
jira_get_issue | 按密钥获取问题(issueKey, fields?) |
jira_create_issue | 创建问题(projectKey, summary, issueType, description?, assignee?, priority?, labels?) |
jira_update_issue | 更新问题字段(issueKey，+任何字段） |
jira_delete_issue | 删除问题(issueKey) |
评论
| 工具 | 说明 |
|---|---|
jira_get_comments | 获取问题评论(issueKey) |
jira_add_comment | 添加评论(issueKey, body) |
过渡
| 工具 | 说明 |
|---|---|
jira_get_transitions | 获取可用转换(issueKey) |
jira_transition_issue | 更改问题状态(issueKey, transitionId) |
短跑和滑板
| 工具 | 说明 |
|---|---|
jira_list_boards | 列表板(projectKeyOrId?) |
jira_get_sprints | 冲刺板(boardId, state?, maxResults?) |
jira_get_sprint_issues | 获取sprint问题(sprintId, maxResults?) |
项目
| 工具 | 说明 |
|---|---|
jira_list_projects | 列出所有项目 |
jira_get_project | 获取项目详细信息(projectKeyOrId) |
报告
| 工具 | 说明 |
|---|---|
jira_sprint_report | Sprint进度报告：完成百分比、速度趋势、结转风险、危险信号(boardId, sprintCount?) |
仪表盘
| 工具 | 说明 |
|---|---|
jira_setup_dashboard | 创建一个带有已保存过滤器的仪表板，用于项目监控(projectKey, dryRun?) |
Sprint报告
jira_sprint_report 为当前和最近的冲刺生成进度报告：
- 主动冲刺 --SP完成百分比、已用时间与剩余时间、落后于计划警告
- 按状态 --按故事点分为已完成/进行中/待完成
- 结转风险 --不完整的问题可能会蔓延到下一个冲刺阶段
- 速度趋势 --在过去的N次冲刺中，计划与完成的SP
- 红旗 --当速度连续下降2次以上冲刺时触发
仪表板设置
jira_setup_dashboard 创建一整套Jira保存的过滤器和仪表板。它 自动检测项目状态 并相应地调整所有JQL查询——需要工作流中不存在的状态的过滤器将被跳过并给出解释。
涵盖6个领域（最多15个过滤器，具体取决于您的工作流程）：
1.Sprint健康状况
- 按当前冲刺状态划分的问题分布（饼图）
- 拒绝率——问题从测试反弹到进行中
2.团队速度和工作量
- 每个受让人的工作量：处于活动状态的问题（二维过滤器）
- 丢失的任务：未分配的问题不在待办事项列表中
- 速度图——作为内置Jira小工具手动添加
3.阻断器和依赖关系
- 处于活动状态的“被阻止”链接存在问题
- 进展中>5天
- 测试受阻>3天
4.释放管道
- 发布候选状态中的问题
- 已完成等待发布构建的问题
- 过去4周的发布
5.质量指标
- 打开严重/高错误
- 创建的Bug与解决的Bug（30天）
- 发布候选人拒绝
6.路线图进展
- 包含所有项目史诗的史诗级视图
- 缺少故事点估计的问题
用法
# Preview the plan (no changes made)
jira_setup_dashboard: projectKey="SP", dryRun=true
# Create dashboard + filters in Jira
jira_setup_dashboard: projectKey="SP"创建后：
- 从输出中打开仪表板URL
- 点击“添加小工具”
- 添加链接到创建的筛选器的推荐小工具类型
- Sprint Burndown和Velocity Chart——添加为标准Jira小工具（选择板，不需要过滤器）
例子
Find all open bugs in project WEB
→ jira_search: jql="project = WEB AND type = Bug AND status != Done"
Show issue SP-123
→ jira_get_issue: issueKey="SP-123"
Create a task in project WEB
→ jira_create_issue: projectKey="WEB", summary="...", issueType="Task"
Move SP-123 to Done
→ jira_get_transitions + jira_transition_issue
What's in the current sprint?
→ jira_list_boards → jira_get_sprints(state="active") → jira_get_sprint_issues
Sprint health check
→ jira_sprint_report: boardId=60
Set up project monitoring
→ jira_setup_dashboard: projectKey="SP", dryRun=true发展
npm run build # Compile TypeScript
npm run lint # Biome linter
npm run format # Biome formatter
npm run typecheck # TypeScript type check
npm run ci # Full CI pipeline (biome ci + typecheck)