Jira MCP Server助手

你是否曾经希望AI能够直接在Jira中创建任务、分配问题、更新状态，而无需在IDE和Jira网页之间反复切换？今天要介绍的开源项目Jira MCP Server助手，正是为了实现这个目标而设计的。它通过模型上下文协议启用与Jira的自然语言交互，让你可以通过Claude Desktop或Cursor管理项目、问题、任务和工作流。

项目基本信息

一、项目介绍

Jira MCP Server助手是一个让AI能够与Jira交互的MCP服务器。它支持Jira的核心功能，包括项目创建和配置、问题和子任务管理、问题链接和依赖关系、自动化问题工作流等。

这个项目提供了以下工具类别：

• 用户管理：通过电子邮件获取用户的账户ID
• 问题类型管理：列出所有可用的问题类型
• 问题链接类型：列出所有可用的问题链接类型
• 问题管理：检索、创建、更新、删除问题，管理子任务和依赖关系

通过这个服务器，你可以用自然语言让AI执行各种Jira操作，例如“创建一个高优先级的Bug，分配给张三”、“列出我所有的未完成任务”、“将PROJECT-123的状态改为In Progress”。

二、核心优势

功能全面

覆盖了Jira项目管理的核心操作：

• 问题管理（CRUD、子任务、链接、依赖）
• 用户信息查询
• 问题类型和链接类型管理
• 支持JQL高级查询

自然语言交互

通过自然语言与Jira交互，委托项目管理任务。例如，结合团队成员及其专长列表，AI可以将新问题自动分配给最相关的人员。

多客户端支持

支持Claude Desktop和Cursor两种主流MCP客户端，配置简单。

JQL查询支持

支持使用JQL（Jira Query Language）进行高级问题过滤和检索，灵活获取所需数据。

完整的错误处理

为无效问题键、缺少必填字段、权限问题、API速率限制等情况提供详细的错误消息。

三、适用场景

AI辅助项目管理

让AI帮你创建任务、分配问题、更新状态，节省手动操作时间。

自动化工作流

结合团队信息，AI可以自动将新问题分配给合适的成员。

项目状态查询

用自然语言查询项目进度，例如“列出所有未关闭的Bug”、“本周完成了哪些任务”。

问题批量操作

AI可以批量创建、更新或删除问题，提高效率。

四、安装教程

系统要求

安装步骤

第一步：获取Jira API令牌

1. 登录Atlassian账户
2. 访问 https://id.atlassian.com/manage-profile/security/api-tokens
3. 点击“Create API token”
4. 复制并保存生成的令牌

第二步：克隆项目并安装依赖

git clone https://github.com/George5562/Jira-MCP-Server.git
cd Jira-MCP-Server
npm install

第三步：配置环境变量

在项目根目录创建.env文件：

JIRA_HOST=your-instance.atlassian.net
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token

第四步：构建项目

npm run build

第五步：配置MCP客户端

对于Claude Desktop：

找到配置文件：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json

添加配置：

{
  "mcpServers": {
    "jira-server": {
      "command": "node",
      "args": ["/path/to/jira-server/build/index.js"],
      "env": {
        "JIRA_HOST": "your-instance.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

对于Cursor：

创建或编辑~/.cursor/mcp.json：

{
  "mcpServers": {
    "jira-mcp-server": {
      "command": "node",
      "args": ["/path/to/Jira-MCP-Server/build/index.js"],
      "env": {
        "JIRA_HOST": "your-instance.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

第六步：重启客户端

保存配置后，重启Claude Desktop或Cursor。

五、使用示例

配置完成后，你就可以在MCP客户端中使用自然语言来操作Jira了。

示例1：获取用户信息

用户指令：“获取user@example.com的账户ID”

AI会调用用户管理工具，返回账户ID。

示例2：列出问题类型

用户指令：“列出所有可用的问题类型”

AI会调用问题类型管理工具，返回id、name、description等信息。

示例3：检索问题

用户指令：“列出PROJECT项目中所有未完成的任务”

AI会调用问题检索工具：

{
  "projectKey": "PROJECT",
  "jql": "status != Done"
}

获取分配给自己的问题：

{
  "projectKey": "PROJECT",
  "jql": "assignee = currentUser() ORDER BY created DESC"
}

示例4：创建问题

用户指令：“在PROJECT项目中创建一个高优先级的Bug，标题是‘登录页面崩溃’，描述详细说明问题，分配给user@example.com”

AI会调用创建问题工具：

{
  "projectKey": "PROJECT",
  "summary": "登录页面崩溃",
  "issueType": "Bug",
  "description": "详细描述...",
  "assignee": "accountId",
  "priority": "High"
}

创建子任务：

{
  "parent": "PROJECT-123",
  "projectKey": "PROJECT",
  "summary": "子任务标题",
  "issueType": "Subtask",
  "assignee": "accountId"
}

示例5：更新问题

用户指令：“将PROJECT-123的状态改为In Progress，优先级改为High”

AI会调用更新问题工具：

{
  "issueKey": "PROJECT-123",
  "status": "In Progress",
  "priority": "High"
}

示例6：创建问题依赖关系

用户指令：“创建问题链接：PROJECT-123阻塞PROJECT-124”

AI会调用问题链接工具：

{
  "linkType": "Blocks",
  "inwardIssueKey": "PROJECT-124",
  "outwardIssueKey": "PROJECT-123"
}

示例7：删除问题

用户指令：“删除PROJECT-123及其所有子任务”

AI会调用删除问题工具：

{
  "issueKey": "PROJECT-123",
  "deleteSubtasks": true
}

示例8：描述字段格式化

描述字段支持Markdown样式：

任务概述：

此任务涉及实现新功能：
- 功能A的实现
- 功能B的测试

步骤：
1. 设计组件
2. 实现逻辑

验收标准：
- 所有测试通过

六、常见问题

问题1：提示“JIRA_API_TOKEN无效”

解决方案：

• 确认API令牌正确且未过期
• 在https://id.atlassian.com/manage-profile/security/api-tokens重新生成
• 检查JIRA_EMAIL是否正确

问题2：无法连接到Jira实例

解决方案：

• 确认JIRA_HOST格式正确（如your-instance.atlassian.net，不要加https://）
• 检查网络是否可以访问Jira
• 确认账户有访问该Jira实例的权限

问题3：创建问题时提示“缺少必填字段”

解决方案：

• 确认提供了projectKey、summary、issueType
• 某些项目可能要求特定字段，检查Jira配置

问题4：JQL查询不返回结果

解决方案：

• 检查JQL语法是否正确
• 确认字段名称与Jira实例匹配
• 使用get_user工具确认账户ID正确

问题5：Cursor中无法使用

解决方案：

• 确认build/index.js文件存在（运行npm run build）
• 检查路径是绝对路径
• 查看Cursor的开发者控制台获取错误信息

七、总结

Jira MCP Server助手是MCP生态中第一个专门为Atlassian Jira设计的官方风格服务器。它让AI能够通过自然语言与Jira交互，实现项目管理的自动化。

这个项目的最大价值在于：

1. 功能完整：覆盖问题CRUD、子任务、链接、依赖等核心功能
2. 自然语言交互：用日常语言管理Jira，无需记忆JQL语法
3. 多客户端支持：兼容Claude Desktop和Cursor
4. JQL支持：需要时可以使用高级查询
5. MIT许可证：可自由使用和修改

如果你是Jira用户，并且希望用AI来辅助项目管理，Jira MCP Server助手将极大地提升你的工作效率。