Jira Delivery

Name: Jira Delivery
Author: teransarathchandra

本地服务

github.com/teransarathchandra生产力01 周前更新

代码仓库

关于 Jira Delivery

Jira Delivery 是供编码 Agent 使用的 Jira Cloud MCP 服务和 Agent 技能，用于准备工单、按验收标准检查本地分支，并生成 QA 交接材料。默认只读；启用写入后，操作也会先预览并等待批准。

主要功能

01生成工单工作简报
02按验收标准检查代码变更
03生成可追溯性矩阵
04创建 QA 交接、发布说明和测试计划
05搜索 Jira 与 Confluence 内容
06经批准后写回工单

适用场景

01开始工单前整理阻塞项与后续步骤
02提交 PR 前核对分支与验收标准
03为 QA 准备交接材料和测试计划
04搜索项目文档并补充工单上下文

MCP 相关

MCP 服务连接 Jira Cloud，并可搜索 Confluence 内容，为客户端提供工单准备、变更检查和交接工具。默认只读；启用写入后，写入操作会预览并等待批准。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "teransarathchandra-jira-delivery": {
      "command": "npx",
      "args": [
        "-y",
        "jira-delivery-mcp"
      ],
      "env": {
        "JIRA_BASE_URL": "<JIRA_BASE_URL>",
        "JIRA_EMAIL": "<JIRA_EMAIL>",
        "JIRA_API_TOKEN": "<JIRA_API_TOKEN>",
        "JIRA_ENABLE_WRITES": "<JIRA_ENABLE_WRITES>"
      }
    }
  }
}

启动命令npx -y jira-delivery-mcp

需要配置的环境变量

JIRA_BASE_URLYour Jira Cloud site, e.g. https://your-domain.atlassian.net

JIRA_EMAILEmail of the Atlassian account the API token belongs to

JIRA_API_TOKEN密钥Atlassian API token

JIRA_ENABLE_WRITEStrue to register the write tools (comment, transition, assign, link); off by default

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmjira-delivery-mcp2.0.0stdio

工具

收录的工具列表 · 更新于 4 天前

参数	类型	必填	说明
depth	enum	否	basic = 仅 issue；full = 親级、史诗、关联 issue、子任务和评论也包含在内basic \| full
issueKey	string	是	Jira issue key（例如 PROJ-123）
includeConfluence	boolean	否	同时搜索 Confluence 中的相关页面，并将其纳入结果（会启用 full depth）

详细介绍

面向 Jira Cloud 的 MCP 服务和 Agent 技能。为工单准备好可直接开始构建的说明，
在创建 PR 前，根据验收标准检查你的分支，然后从编码 Agent 中交接。

工作原理

1 · 开始处理工单

“我要开始处理 ABC-1，帮我做好准备。”

在你写下一行代码之前，了解准备情况、阻碍因素、验收标准、后续步骤和分支名称。

2 · 创建 PR 前进行验证

“创建 PR 前，检查我的分支是否符合 ABC-1 的要求。”

根据验收标准和完成定义检查本地差异，并给出一个结论——ready_for_pr、needs_work 或 insufficient_evidence——以及每项标准对应的文件。

3 · 交接

“将 QA 交接内容发布到 ABC-1。”

QA 交接内容、发行说明、测试计划和评审。启用回写后，Agent 会显示预览并等待你批准。

## 安装

你需要 Node.js 22+、Jira Cloud URL、Atlassian 邮箱和一个 API token。

Claude Code — 包含服务和技能的插件

/plugin marketplace add teransarathchandra/jira-mcp-server
/plugin install jira-delivery@jira-delivery

它会要求你提供站点、邮箱和 token（token 会存储在安全存储中）。如果不使用插件：

claude mcp add jira-delivery \
  -e JIRA_BASE_URL=https://your-domain.atlassian.net \
  -e [email protected] \
  -e JIRA_API_TOKEN=your-api-token \
  -- npx -y jira-delivery-mcp

Cursor

点击 添加到 Cursor 并替换三个占位值，或将下方的 JSON 添加到 ~/.cursor/mcp.json。

VS Code（GitHub Copilot Agent 模式）

点击 在 VS Code 中安装（或使用 Insiders）。VS Code 会要求你提供站点、邮箱和 token，并将 token 存储为机密。

手动配置：添加到 .vscode/mcp.json — VS Code 使用 servers，而不是 mcpServers：

{
  "servers": {
    "jira-delivery": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "jira-delivery-mcp"],
      "env": { "JIRA_BASE_URL": "https://your-domain.atlassian.net", "JIRA_EMAIL": "[email protected]", "JIRA_API_TOKEN": "your-api-token" }
    }
  }
}

Windsurf · README 配图

Claude Desktop · 任意 MCP 客户端

添加到客户端的 MCP 配置中 — Windsurf：设置 → MCP 服务；Claude Desktop：claude_desktop_config.json：

{
  "mcpServers": {
    "jira-delivery": {
      "command": "npx",
      "args": ["-y", "jira-delivery-mcp"],
      "env": { "JIRA_BASE_URL": "https://your-domain.atlassian.net", "JIRA_EMAIL": "[email protected]", "JIRA_API_TOKEN": "your-api-token" }
    }
  }
}

⌨️ Codex CLI

在 ~/.codex/config.toml 中：

[mcp_servers.jira-delivery]
command = "npx"
args = ["-y", "jira-delivery-mcp"]
env = { JIRA_BASE_URL = "https://your-domain.atlassian.net", JIRA_EMAIL = "[email protected]", JIRA_API_TOKEN = "your-api-token" }

**检查设置：**导出这三个变量后，运行 npx jira-delivery-mcp doctor，即可验证登录并打印站点所需的自定义字段 ID（验收标准、故事点、史诗）。其他 Agent 可以添加 jira-delivery 技能，该技能也附在每个发行版中。

工具

步骤	工具
开始	`jira_search_issues` · `jira_get_issue` · `jira_prepare_work_brief`
验证	`delivery_check_changes` · `delivery_traceability_matrix`
交接	`delivery_generate` · `jira_add_comment`* · `jira_update_issue`*
上下文	`confluence_search` · `confluence_get_page` · `delivery_project_patterns` · `delivery_generate_agent_pack`