AI导哈

Jira集成工具

Jira-MCP是一个连接Cursor AI和Jira Cloud工作区的模型上下文协议服务器，支持直接在IDE中查询任务、问题、冲刺和评论。

  • by WenchuanLiliZhao
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 WenchuanLiliZhao/jira-mcp

使用说明

Jira MCP

A. 模型上下文协议（MCP） 连接的服务器 光标AI 转到您的Jira Cloud工作区。直接从IDE查询任务、问题、冲刺和注释——无需脚本，无需复制粘贴，只需询问即可。

运作原理

安装后，Cursor AI可以作为原生工具访问Jira数据。你可以问这样的问题：

“现在分配给我的是什么？” “向我展示PROJ-42的详细信息和评论。” “当前冲刺中有什么问题？”

人工智能选择正确的工具，调用Jira API，并在聊天中显示结果。

对于脚本或终端使用，还包括CLI查询脚本。

项目结构

Jira-MCP/
├── lib/                       Shared core (credentials, Jira API client)
│   ├── config.js              Credential loading, active-project state
│   └── jira-client.js         Authenticated fetch, data formatters, fetchers
│
├── mcp/                       MCP server (Cursor AI integration)
│   └── server.js
│
├── cli/                       CLI tools (terminal / automation)
│   ├── query.js               Query issues by status, assignee, or JQL
│   ├── bulk-move.js           Move issues between projects
│   ├── bulk-assign.js         Assign issues to yourself
│   ├── bulk-transition.js     Transition issues to a target status
│   ├── set-epic-link.js       Link issues to an epic
│   └── set-project-description.js  Set a project's description
│
├── config/                    Configuration (gitignored secrets + state)
│   ├── secrets.json           Jira credentials (local only)
│   ├── secrets.json.example   Template for secrets.json
│   └── state.json             Active project state (local only)
│
├── scripts/                   Install & link helpers
│   ├── install.sh             npm install + MCP server registration
│   └── link-to-project.sh    Symlink commands into any project
│
└── package.json

特性

MCP工具（光标AI集成）

工具 状态 描述
list_projects ✅ 列出经过身份验证的用户可访问的所有Jira项目
list_issues ✅ 使用可选JQL筛选器列出项目中的问题
get_issue ✅ 完整问题详细信息：描述、评论、冲刺、附件、时间跟踪、子任务、链接问题
search_issues ✅ 使用任何自定义JQL查询进行搜索
get_my_issues ✅ 当前分配给已验证用户的问题
list_sprints ✅ 列出项目的冲刺（活动/未来/已关闭）
get_sprint_issues ✅ 特定冲刺中的所有问题
get_active_project ✅ 从当地州读取当前活动的项目密钥和板
set_active_project ✅ 将活动项目（持久化为 config/state.json)；由AI在“切换到X”请求时使用
create_issue ✅ 创建新问题（摘要、类型、描述、受让人、优先级、标签、父级、故事点）；description接受Markdown
update_issue ✅ 更新现有问题的任何字段；仅更改提供的字段；description接受Markdown
添加评论 🔲 在IDE中对某个问题发表评论
get_transitions ✅ 列出问题的可用工作流转换，包括自定义状态（在转换前使用_issue）
transition_issue ✅ 将问题移动到新状态（例如“进行中”→ 完成）；支持带有可选Markdown注释的自定义状态（例如测试）
assign_issue ✅ 将问题分配或重新分配给用户（或通过传递null取消分配）
search_users ✅ 通过姓名或电子邮件查找团队成员；返回accountId以用于分配/创建
附件下载 🔲 获取附件内容（不仅仅是元数据）

get_issue --返回字段

字段 描述
description 完整的问题描述（纯文本，从Atlassian文档格式转换而来）；Markdown在书写时呈现
comments [{ author, created, body }] --谁说了什么，什么时候说的
sprint { id, name, state, startDate, endDate } 或 null
story_points 数值估算或 null
timetracking { original, remaining, spent } 或 null
attachments [{ filename, url, mimeType, size }]
subtasks [{ key, summary, status }]
issuelinks [{ type, issue }] --阻塞/被阻塞/与
components 组件名称
resolution 例如。 "Fixed", "Won't Do"，或 null
assignee, reporter, priority, labels 标准字段

CLI查询脚本

命令 描述
npm run done 我已完成的问题
npm run inprogress 我正在处理的问题
npm run todo 我的待办事项
npm run all 我所有的问题，无论地位如何
npm run query -- --project PROJ 特定项目的问题
npm run query -- --jql "..." 原始JQL查询
npm run move -- --from SRC --to DST 在项目之间移动所有问题
npm run move -- --from SRC --to DST --jql "..." 在项目之间移动筛选的问题
npm run assign -- --project PROJ 将项目中的所有问题分配给自己
npm run assign -- --project PROJ --jql "..." 将筛选后的问题分配给自己
npm run set-epic-link -- --epic EPIC --issue KEY 将一个或多个问题链接到史诗
npm run transition -- --to STATUS --jql "..." 向目标状态过渡的问题

设置和AI指导

功能 状态 描述
互动 /Jira-MCP/install 命令 ✅ AI引导的设置：收集凭据，验证API访问权限，写入 config/secrets.json
/Jira-MCP/jira 命令 ✅ 游标AI规则告诉AI何时以及如何使用每个Jira工具
/Jira-MCP/confluence 命令 ✅ 用于查询Confluence空间和页面的游标AI规则
/Jira-MCP/jira-create-issues 命令 ✅ 用于规划和创建Jira任务和史诗的游标AI规则
自动安装脚本 ✅ scripts/install.sh --在一个命令中安装npm+注册MCP服务器
基于Symlink的项目链接 ✅ scripts/link-to-project.sh --将命令链接到任何项目中
项目特定配置被忽略 ✅ config/secrets.json, config/state.json 仅限于本地； .example 文件已提交以供参考
引导式令牌生成链接 ✅ /Jira-MCP/install 直接链接到Atlassian API令牌页面
多项目支持 ✅ set_active_project / get_active_project 工具；通过询问AI进行切换
热重新加载凭据 ✅ 每次请求时都会重新读取凭据——在不重新启动Cursor的情况下切换帐户
令牌到期时自动刷新 🔲 检测401并提示输入新令牌

快速开始

AI辅助安装（推荐）

在Cursor中打开任何项目 代理模式 并说：

“帮我安装https://github.com/<用户>/Jira MCP“

AI将克隆仓库，运行设置脚本，将命令链接到您的项目中，并引导您完成凭据配置。

手动安装

# 1. Clone the repo
git clone https://github.com/<user>/Jira-MCP.git ~/Jira-MCP

# 2. Install deps + register MCP server
bash ~/Jira-MCP/scripts/install.sh

# 3. Link commands into your project
bash ~/Jira-MCP/scripts/link-to-project.sh /path/to/your/project

# 4. Restart Cursor, then run in Agent mode:
/Jira-MCP/install

这 /Jira-MCP/install 命令将引导您完成Jira凭据设置。

看 安装.md 了解完整的详细信息和故障排除。

需求

  • Node.js 18+
  • 游标IDE（支持MCP的任何版本）
  • 使用API令牌的Jira云帐户
  • 已安装npm包(npm install)--Markdown需要→ ADF转换(md-to-adf)

安全

  • 凭据存储在 config/secrets.json，如所列 .gitignore 从未承诺过。
  • API令牌授予与您的Atlassian帐户相同的访问权限-将其视为密码。
  • 代币可以随时撤销 id.atlassian.com.

安装后

您的项目收益 一个符号链接 --其他内容不会被复制或修改：

my-proj/
├── .cursor/
│   └── commands/
│       ├── Jira-MCP/          ← symlink to the cloned repo (install, jira, confluence, jira-create-issues)
│       └── (your own commands, untouched)
├── src/
└── package.json

MCP服务器， node_modules，凭据保留在克隆的仓库中（例如。 ~/Jira-MCP/).它们从不进入您的项目目录。

为什么这不是一种技能

Jira MCP使用 光标命令 （斜线命令如 /Jira-MCP/jira)，而不是技能框架。

命令 技能
激活 用户显式运行 /Jira-MCP/jira --精确、按需 代理根据描述推断——可能会错过或超过触发
代币成本 仅加载您调用的命令（约500个令牌） 匹配时加载整个技能文件（约2500个令牌）
孤立 所有命令都在 Jira-MCP/ --不会污染您的其他命令 不适用

对于Jira工作流来说，命令更高效、更可预测。安装脚本和链接脚本句柄设置；不需要技能包装。

相关 MCP