🔌

Jira MCP

Productivity850

Manage Jira issues, projects, and workflows for agile project management.

Claude DesktopCursorWindsurf

Overview

Manage Jira issues, projects, and workflows for agile project management.

Setup

Run with npx:

npx -y @modelcontextprotocol/server-jira

Configuration

JIRA_HOST, JIRA_EMAIL, JIRA_API_TOKEN environment variables

Documentation

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

  1. 登录 https://id.atlassian.com
  2. 点击个人资料 → 安全 → API 令牌
  3. 创建新令牌并复制

Available Tools

ToolDescription
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 报告时
  • 想要跟踪项目进度时

Resources