Jira Delivery

io.github.teransarathchandra由 GitHub 账号 teransarathchandra 发布v2.0.0更新于 Oct 25, 2026

Jira Cloud delivery layer: ticket briefs, acceptance-criteria checks before the PR, QA handoff.

概览

AI 生成的概览

本地运行的 Jira Cloud 交付助手:把工单转成实现简报,用验收标准检查本地改动,并生成 QA 交接与 PR 前检查。

可以做什么
搜索并读取 Jira 工单,包括父级、史诗和关联工单的完整上下文,并查找相关的 Confluence 页面与页面摘要。把工单整理成可直接实现的简报,包含目标、验收标准、约束和实施提示词。将本地代码差异与验收标准和完成定义比对,并生成需求追踪矩阵,把每条标准映射到改动文件。生成测试策略、评审报告、QA 交接、发布说明和任务报告。识别并保存仓库约定,向仓库写入可复用的智能体提示词或命令。
适用场景
适合在 Jira Cloud 上配合编码智能体处理工单时使用,用于结构化开工、提交 PR 前按验收标准检查就绪度,以及生成交接或发布产物。
运行要求
通过 npx 以 stdio 在本地运行,需要 Node.js 22 及以上。需要设置 JIRA_BASE_URL、JIRA_EMAIL 和 JIRA_API_TOKEN,并能访问你的 Atlassian 站点。仅在 JIRA_ENABLE_WRITES=true 时注册写入工具;保存项目模式需要 DELIVERY_PATTERN_MEMORY_ENABLED=true。
安装前请注意
API 令牌属于凭据,应保存在环境变量或安全存储中。写入工具(评论、状态流转、指派、关联)默认关闭;启用后可修改 Jira 工单,不过 README 称写入会先预览并需批准。delivery_generate_agent_pack 和模式存储会向你的仓库写入文件。工单文本被视为不可信数据。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Jira Delivery,将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only,通过 STDIO。 STDIO 服务会启动本地进程,因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[Jira Delivery MCP: from Jira ticket to merged PR without leaving your coding agent]

[npm version] [CI] [Tool-selection evals: 36/36] [Node.js 22 or newer] [MIT license]

An MCP server and agent skill for Jira Cloud. Start a ticket with a ready-to-build brief,
check your branch against its acceptance criteria before the PR, and hand off — from your coding agent.

[Install in Claude Code] [Add to Cursor] [Install in VS Code]

How it works

1 · Start a ticket

"I'm starting ABC-1, get me ready."

Readiness, blockers, acceptance criteria, next steps and a branch name — before you write a line.

[The agent lists open issues, then gets a ready-to-build brief for ABC-1]

2 · Verify before the PR

"Check my branch against ABC-1 before I open the PR."

Your local diff against the acceptance criteria and Definition of Done, with one verdict — ready_for_pr, needs_work or insufficient_evidence — and the files behind each criterion.

[The branch covers one of two criteria, so the verdict is needs_work]

3 · Hand off

"Post the QA handoff to ABC-1."

QA handoffs, release notes, test plans and reviews. With write-back on, the agent shows you a preview and waits for your approval.

[A comment is previewed; nothing changes in Jira until the user approves]

Install

You need Node.js 22+, your Jira Cloud URL, your Atlassian email and an API token.

[图片] Claude Code — plugin with the server and the skill
/plugin marketplace add teransarathchandra/jira-mcp-server/plugin install jira-delivery@jira-delivery

It asks for your site, email and token (the token goes to secure storage). Without the plugin:

bash
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

Click Add to Cursor and replace the three placeholder values, or add the JSON below to ~/.cursor/mcp.json.

[图片] VS Code (GitHub Copilot agent mode)

Click Install in VS Code (or Insiders). VS Code asks for your site, email and token and stores the token as a secret.

Manually: add to .vscode/mcp.json — VS Code uses servers, not mcpServers:

json
{  "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 · [图片] Claude Desktop · any MCP client

Add to the client's MCP config — Windsurf: Settings → MCP Servers; Claude Desktop: claude_desktop_config.json:

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

In ~/.codex/config.toml:

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" }

Check your setup: with the three variables exported, npx jira-delivery-mcp doctor verifies the login and prints the custom-field ids your site needs (acceptance criteria, story points, epic). Other agents can add the jira-delivery skill, also attached to each release.

Tools

StepTools
Startjira_search_issues · jira_get_issue · jira_prepare_work_brief
Verifydelivery_check_changes · delivery_traceability_matrix
Hand offdelivery_generate · jira_add_comment* · jira_update_issue*
Contextconfluence_search · confluence_get_page · delivery_project_patterns · delivery_generate_agent_pack

* Opt-in with JIRA_ENABLE_WRITES=true. Every tool returns typed structuredContent; see the tool reference.

Safe by default

  • 🔒 Local and private — runs on your machine over stdio; talks only to your Atlassian site; no telemetry.
  • ✋ Read-only unless you opt in — and then every write is previewed, waits for your approval, is sent once and audited.
  • 🧱 Ticket text is untrusted — fenced as data, scanned for prompt injection, never turned into instructions.
  • 🗝️ Credentials stay in your environment — never logged; redacted from all output.

Documentation

Usage · Tools · Configuration · Security · Troubleshooting · Migrating from 1.x · Changelog

Contributing

Issues and pull requests are welcome — see CONTRIBUTING.md. Security reports: SECURITY.md.

MIT © Teran Sarathchandra

来源:README.md,提交 521a77b

工具

10

jira_get_issue

Get a Jira issue

Fetch a Jira issue as a developer brief: description, acceptance criteria, comments and attachments. Use depth "full" for parent/epic/linked-issue context and includeConfluence for related documentation. Use this to read a ticket. To start work, check readiness, verify changes or write a report, call jira_prepare_work_brief or the delivery_* tool directly: they fetch the issue themselves.

输入参数depthissueKey必填includeConfluence

jira_search_issues

Search Jira issues

List open Jira issues assigned to the authenticated user, optionally limited to one project. Use this to find what to work on next. Pass jql to search with your own filter instead (e.g. "type = Bug AND sprint in openSprints() ORDER BY priority DESC"); it is limited to projectKey when given, and to the allowed projects when the strict allowlist is on. When more results exist, data.nextPageToken is set: pass it back as pageToken for the next page.

输入参数jqlpageTokenmaxResultsprojectKey

jira_prepare_work_brief

Prepare a work brief for a Jira issue

Turn a Jira issue into a ready-to-implement brief for a coding agent: goal, acceptance criteria, constraints and an implementation prompt. Use this when starting work on a ticket, or to check whether it is ready to start (readiness, blockers, missing acceptance criteria). Fetches the issue itself.

输入参数depthissueKey必填allowElicitationincludeConfluence

confluence_get_page

Get a Confluence page

Read a Confluence page by ID and return a cleaned, size-bounded summary of its content.

输入参数pageId必填maxChars

delivery_check_changes

Check local changes against a Jira issue

Check work on a Jira issue: does the branch cover the acceptance criteria and meet the Definition of Done? alignment and dod compare the local diff with them — run them before opening a PR. impact predicts the affected areas and works before any code is written, so use checks ["impact"] when planning. Each check runs independently. Returns a verdict (ready_for_pr, needs_work, insufficient_evidence; not_applicable when only impact ran) and per-criterion coverage. Fetches the issue itself.

输入参数checksissueKey必填repoPathbaseBranchcompareRefmaxDiffCharsincludeConfluence

delivery_traceability_matrix

Build a requirement traceability matrix

Build a requirements traceability matrix: map each requirement and acceptance criterion of a Jira issue to the changed files that implement it, and flag gaps. Fetches the issue itself. For a ready-for-PR verdict use delivery_check_changes.

输入参数issueKey必填repoPathbaseBranchcompareRefincludePrDiffincludeConfluence

delivery_generate

Generate a delivery document for a Jira issue

Generate a delivery artifact from a Jira issue and the local diff: test_strategy, reviewer_report (needs persona), qa_handoff, release_notes (audience) or task_report (combined sections). Use test_strategy to plan tests and reviewer_report to review a ticket from a persona's point of view. Fetches the issue itself. Returns Markdown; writes no files.

输入参数type必填personaaudienceissueKey必填repoPathsectionsbaseBranchcompareRefincludePrDiffincludeConfluence

delivery_generate_agent_pack

Write an agent workflow pack into the repo

Write reusable Jira delivery prompts/commands for a coding agent into the repository (claude: .claude/commands and .claude/skills, codex: .codex-prompts/, generic: .mcp-prompts/).

输入参数client必填repoPathoverwrite

delivery_project_patterns

Scan, read or clear stored project patterns

Detect the repository’s conventions (framework, test layout, tooling) and store them so other delivery tools can tailor their output. scan = detect and store, get = read stored patterns, clear = delete them. Storing requires DELIVERY_PATTERN_MEMORY_ENABLED=true in the server environment.

输入参数action必填repoPath

版本历史

1
  1. v2.0.0最新Oct 25, 2026

评分

已满足适用检查项的 90%

该评分衡量此收录条目的完整程度,依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价,也不表示服务器安全或当前可用:可连通性是带日期的检查结果,评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分
  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头,或保持端点能够响应探测,以便判定其认证方式。

  • 已列出工具必需15 分
  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分