← 返回目录
J

Jira MCP Server

社区
通过自然语言与Jira交互,实现项目管理自动化。
分类
团队协作 第 44 / 55
Stars
★ 64 热门
传输方式
stdio(本地进程)
运行环境
Node.js
凭据
需要 API Key / 凭据
最近提交
⚠
工具数
11
42FMRS · D

该MCP服务器通过自然语言简化Jira操作,适合使用Jira的团队。它提供了全面的问题管理功能,但需要配置有效的凭据,并注意删除操作的风险。

最强项 · 文档质量 12/20 最弱项 · 可靠性 6/20

可靠性
6/20
安全与权限
8/20
维护活跃度
6/20
文档质量
12/20
安装易用性
10/20
查看各项评分依据
可靠性 6/20
源码中可见的MCP服务器初始化及工具定义,但未能执行验证,且错误处理和测试覆盖不足(未见测试代码或CI工作流)。因此给予低于12的评分。
安全与权限 8/20
提供了多种认证方式(basic/bearer)的说明,但未强调最小权限原则,也未对删除操作提供显式确认机制。然而,未发现恶意代码或凭证泄露风险。
维护活跃度 6/20
项目活跃度一般,有开源协议未知,未见持续维护的证据如发布或依赖更新。
文档质量 12/20
README提供了详细的安装、配置和工具使用说明,包括环境变量和客户端配置示例,但缺少故障排除和限制说明。
安装易用性 10/20
安装步骤相对清晰,提供了多种客户端配置示例(Claude Desktop、Cursor),但未包含真正的CI或测试验证,因此低于15分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

  • 使用Jira进行项目管理的团队
  • 希望用自然语言与AI助手交互来管理任务的用户
  • 需要自动化常见PM操作(如分配、更新状态)的开发者

不适合谁

  • 未使用Jira的用户
  • 需要复杂权限管理的场景
  • 不需要自然语言交互,仅需API调用的开发者

所需权限

  • 读取Jira项目、问题和用户信息
  • 创建、更新和删除问题及子任务
  • 创建问题链接(依赖关系)
  • 需要JIRA_HOST、JIRA_API_TOKEN或PAT,以及基本认证时的JIRA_EMAIL

风险与副作用

  • 如果API令牌泄露,攻击者可访问和修改Jira数据
  • 删除操作不可逆,可能导致数据丢失(尤其是删除子任务时)
  • 错误配置可能导致权限问题或API速率限制
  • 依赖Jira API版本,可能受实例限制

安装接入

准备工作

运行环境:Node.js

JIRA_HOST 必填 你的 Jira 实例主机名,例如 your-jira-instance.atlassian.net
JIRA_EMAIL 必填 你的 Jira 账户邮箱,使用 basic 认证时必填
JIRA_API_TOKEN 必填密钥 API 令牌(从 https://id.atlassian.com/manage-profile/security/api-tokens 获取)或 Personal Access Token,为机密信息
其他可选配置项(2 个)
JIRA_AUTH_TYPE 可选 认证类型,basic(默认)或 bearer(使用 PAT 时设置),可选
JIRA_API_VERSION 可选 Jira API 版本,默认为 3,可选
  1. 克隆仓库:git clone https://github.com/George5562/Jira-MCP-Server.git
  2. 安装依赖:npm install
  3. 配置环境变量:创建.env文件,设置JIRA_HOST、JIRA_API_TOKEN和JIRA_AUTH_TYPE(可选JIRA_EMAIL用于基本认证)
  4. 构建项目:npm run build
  5. 启动服务器:npm start

对于Claude Desktop,在配置文件(claude_desktop_config.json)中添加mcpServers条目。

claude_desktop_config.json
{
  "mcpServers": {
    "jira-server": {
      "command": "node",
      "args": [
        "/path/to/jira-server/build/index.js"
      ],
      "cwd": "/path/to/jira-server",
      "env": {
        "JIRA_HOST": "your-jira-instance.atlassian.net",
        "JIRA_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_AUTH_TYPE": "basic"
      }
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同(如 VS Code 使用 servers 字段),可用下方配置生成器转换。

.vscode/mcp.json
{
  "servers": {
    "jira-server": {
      "command": "node",
      "args": [
        "/path/to/jira-server/build/index.js"
      ],
      "cwd": "/path/to/jira-server",
      "env": {
        "JIRA_HOST": "your-jira-instance.atlassian.net",
        "JIRA_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_AUTH_TYPE": "basic"
      }
    }
  }
}

写入项目的 .vscode/mcp.json(VS Code 使用 servers 字段)。

Terminal
claude mcp add jira-server -e JIRA_HOST=your-jira-instance.atlassian.net -e [email protected] -e JIRA_API_TOKEN=your-api-token -e JIRA_AUTH_TYPE=basic -- node /path/to/jira-server/build/index.js

在终端运行;先把 <…> 占位符换成你自己的值。

验证是否装好

重启客户端后,在工具列表中应能看到 CreateIssue、GetIssuesFromProject 等工具;也可以提问'列出 PROJECT 项目的问题',若能返回数据说明连接成功。

常见排障

  1. 如果连接失败,请检查JIRA_HOST是否正确(如:your-instance.atlassian.net)、JIRA_API_TOKEN是否有效、JIRA_AUTH_TYPE是否设置正确(basic或bearer)、以及网络连接是否可达Jira实例。对于PAT,确保已启用PAT支持。

试试这样问

连接成功后,可以直接对 AI 助手这样说:

  • 使用 Jira MCP,列出 PROJECT 项目中所有状态为 In Progress 的问题
  • 通过邮箱 [email protected] 查询该用户的 Jira 账户 ID,并把 PROJECT-123 分配给他
  • 在 PROJECT 项目里创建一个类型为 Task、优先级为 High、标题为'修复登录页 Bug'的新问题,并添加两个子任务
  • 把 PROJECT-123 删除,同时删除它的所有子任务

工具能力 11

GetUserByEmail 只读
通过邮件获取用户的账户ID。
GetAllIssueTypes 只读
列出所有可用的问题类型。
GetAllIssueLinkTypes 只读
列出所有可用的链接类型。
GetIssuesFromProject 只读
获取项目中的问题,可使用JQL过滤。
CreateIssue 写入
创建标准问题。
CreateSubtask 写入
创建子任务。
UpdateIssue 写入
更新问题字段。
CreateIssueLink 写入
创建问题链接。
展开其余 3 个工具
DeleteIssue 破坏性
删除单个问题。
DeleteIssueWithSubtasks 破坏性
删除问题及其子任务。
DeleteMultipleIssues 破坏性
批量删除多个问题。

使用场景

获取项目中的所有问题列表
创建新问题或子任务,并分配给团队成员
根据JQL查询过滤问题,如分配给我的任务
更新问题状态、优先级、描述等
建立问题之间的依赖关系(如阻止/被阻止)

支持客户端

Claude Desktop
Cursor

依据项目文档列出,未经本站实测。

详细介绍

这是一个基于Model Context Protocol (MCP)的服务器,允许用户使用自然语言与Jira进行交互,从而获取项目信息并修改项目。它支持项目创建和配置、问题与子任务管理、问题链接与依赖关系,以及自动化问题工作流。

同类可选方案

源版本 009afb88f276 数据同步于 2026-10-12 查看 FMRS 评分方法