Overview
Manage Jira issues, projects, and workflows for agile project management.
Setup
Run with npx:
npx -y @modelcontextprotocol/server-jiraConfiguration
JIRA_HOST, JIRA_EMAIL, JIRA_API_TOKEN environment variablesDocumentation
Jira MCP
Overview
Jira MCP 是一个模型上下文协议服务器,允许 AI 代理直接与 Atlassian Jira 进行交互。通过此 MCP 服务器,AI 可以创建、查询、更新和管理 Jira 问题(Issues)、项目、工作流和仪表板。这对于项目管理、敏捷开发和团队协作场景非常有用。
Jira MCP 支持所有主要的 Jira 功能,包括问题管理、用户分配、状态转换、评论添加、附件处理等。它使得 AI 代理能够成为项目管理助手,自动处理日常任务、生成报告、跟踪进度。
Features
- 问题管理:创建、读取、更新、删除 Jira 问题
- 项目查询:列出项目、获取项目详情
- 工作流操作:转换问题状态、添加工作流注释
- 用户管理:查询用户、分配问题给用户
- 搜索功能:使用 JQL(Jira Query Language)搜索问题
- 评论和附件:添加评论、上传附件
- 仪表板:获取仪表板信息
- 实时通知:订阅问题更新(通过 webhook)
Installation
# 使用 npx 运行
npx -y @modelcontextprotocol/server-jira
# 或使用 uvx
uvx mcp-server-jira
Configuration
添加以下配置到 claude_desktop_config.json:
{
"mcpServers": {
"jira": {
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-jira"],
"env": {
"JIRA_HOST": "https://your-domain.atlassian.net",
"JIRA_EMAIL": "your-email@example.com",
"JIRA_API_TOKEN": "your-api-token"
}
}
}
}
获取 Jira API Token
- 登录 https://id.atlassian.com
- 点击个人资料 → 安全 → API 令牌
- 创建新令牌并复制
Available Tools
| Tool | Description |
|---|---|
jira_list_projects | 列出所有可访问的项目 |
jira_get_project | 获取项目详细信息 |
jira_create_issue | 创建新的 Jira 问题 |
jira_get_issue | 获取问题详情 |
jira_update_issue | 更新问题字段 |
jira_transition_issue | 转换问题状态 |
jira_search_issues | 使用 JQL 搜索问题 |
jira_add_comment | 添加问题评论 |
jira_assign_issue | 分配问题给用户 |
Usage Examples
示例 1:创建新任务
AI: 请创建一个 Jira 任务,标题为"实现用户登录功能",类型为 Story,优先级为 High,指派给 @john.doe
Jira MCP:
- 调用 jira_create_issue
- 设置 summary, issuetype, priority, assignee
- 返回创建的问题 ID: PROJ-123
示例 2:搜索未完成的 Bug
AI: 搜索所有状态不是 Done 的 Bug 类型问题
Jira MCP:
- 执行 JQL: "type = Bug AND status != Done"
- 返回匹配的问题列表
示例 3:更新问题状态
AI: 将 PROJ-100 的状态从 In Progress 改为 Done
Jira MCP:
- 调用 jira_transition_issue
- 找到对应的 transition ID
- 执行状态转换
Pros
- ✅ 完整的 Jira API 覆盖
- ✅ 支持 JQL 高级搜索
- ✅ 支持工作流状态转换
- ✅ 适合项目管理自动化
- ✅ 开源免费
Cons
- ❌ 需要 Jira 账户和 API 令牌
- ❌ 某些高级功能需要 Jira Premium
- ❌ 配置相对复杂
When to Use
- 需要 AI 辅助项目管理时
- 想要自动化日常 Jira 操作时
- 需要生成 Jira 报告时
- 想要跟踪项目进度时
