@dawlabs/jira-cli-mcp

中文文档
0.16.6发布于 2026/10/31MITES Module近 30 天下载 4502

Jira Cloud + Confluence Cloud CLI & MCP server — full Jira REST v3 surface, Confluence spaces/pages with markdown, two-way file sync. Pure Jira + Confluence REST API only (no Rovo, no paid endpoints).

原始使用文档
文档目录7 节
  1. Quick start
  2. Why this one
  3. A day in six commands
  4. Security & boundaries
  5. Install
  6. Docs
  7. Developer

jira-cli-mcp

Jira Cloud + Confluence Cloud from your terminal — and 103 MCP tools for your LLM agents. One tool, both worlds, pure REST.

  • Full practical surface — issues, JQL, sprints/boards/epics, worklogs, attachments, versions, users, identity map, dashboards, workflow maps, XML export, Confluence spaces / markdown pages / two-way file sync.
  • LLM-first help — a help tool over the same docs the package ships; every command and tool discoverable by topic or search (jira help --search).
  • Policy-guarded writes, managed rate limits — per-project read-write / read-only policy, token bucket + Retry-After honoring, visible budget.

Quick start

npm install -g @dawlabs/jira-cli-mcp
jira config init --baseUrl https://yourteam.atlassian.net --email [email protected] --apiToken env:JIRA_API_TOKEN --project DEMO
jira mine          # your open tickets — you're rolling

For agents: jira mcp serve --transport stdio --project DEMO — then ask your client to call help (no args) for the full index.

Why this one

Most Jira CLIs cover a slice; this one aims at the whole practical REST v3 surface with the same core serving humans (tables, --json) and agents (MCP tools, stdio/HTTP/SSE). Configuration lives centralized in ~/.jcm — nothing ever lands inside your repositories. Confluence rides the same account, same binary, same policy guard. Every user-facing error carries a hint and a stable exit code; markdown ⇄ Jira/Confluence rich text converts both ways with round-trip tests.

A day in six commands

jira mine --or dana                      # what's on our plates
jira done --when last-week               # what we shipped
jira blocked                             # what's stuck (Blocked* labels)
jira issue move DEMO-15 --to "In Progress"
jira sprint create -b 7 --name "Sprint 4" --goal "ship 0.2.0"
jira confluence sync push docs/*.md --space DEV

Security & boundaries

  • Talks only to standard Jira/Confluence REST APIs with your own API token — never Rovo, Atlassian Intelligence, Forge/Connect, JPD, or any paid endpoint (per-client allow-lists enforce this in code).
  • Authorization is policy-only: each registered project declares {mode: read-write|read-only, allowedAccounts} — no override flag exists.
  • Credentials stay in ~/.jcm (0600, atomic writes, env:VAR indirection, redacted printing). Tokens never appear in logs or output.

Install

npm install -g @dawlabs/jira-cli-mcp        # npmjs.org (public)
npm install -g @sikancil/jira-cli-mcp       # GitHub Packages mirror

Node ≥ 22.19. Free to use under MIT; distributed as an obfuscated artifact with full documentation — the readable reference is the shipped docs/ (including docs/help/ and docs/llms.txt for agents).

Docs

jira help · jira help --search "…" — help index · CLI reference · MCP setup · Confluence · config · architecture · XML export · llms.txt · CHANGELOG

Developer

Built and maintained by sikancil. The repo is private; issues and pull requests are not open — reach out via the GitHub profile above.

版本与发布记录

@dawlabs/jira-cli-mcp 共发布 35 个版本,首次发布于 2026/10/10;过去 12 个月发布了 35 个版本。

版本发布日期距今
0.16.6latest2026/10/3111 天前
0.16.52026/10/3112 天前
0.16.02026/10/1923 天前
0.15.52026/10/1824 天前
0.15.42026/10/1824 天前
0.15.32026/10/1824 天前

关于 @dawlabs/jira-cli-mcp 的常见问题

@dawlabs/jira-cli-mcp 是什么?

Jira Cloud + Confluence Cloud CLI & MCP server — full Jira REST v3 surface, Confluence spaces/pages with markdown, two-way file sync. Pure Jira + Confluence REST API only (no Rovo, no paid endpoints).

如何安装 @dawlabs/jira-cli-mcp?

在项目目录运行 npm install @dawlabs/jira-cli-mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 jira,可以用 npx jira 直接运行。

@dawlabs/jira-cli-mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/dawlabs__jira-cli-mcp 是否存在。

@dawlabs/jira-cli-mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@dawlabs/jira-cli-mcp 需要什么版本的 Node.js?

package.json 的 engines 字段要求 Node.js >=22.19.0。版本不符时 npm 默认只给出警告,开启 engine-strict 后会拒绝安装。

@dawlabs/jira-cli-mcp 可以商用吗?

@dawlabs/jira-cli-mcp 使用 MIT 许可。宽松许可:允许商业使用、修改和再分发,通常只需在分发时保留原版权与许可声明。以上为概括,不构成法律意见,请以许可原文为准。

@dawlabs/jira-cli-mcp 的下载量有多少?

根据 npm 官方下载统计,@dawlabs/jira-cli-mcp 在 2026/10/12 – 2026/11/10 这 30 天内被下载 4,502 次,日均约 150 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@dawlabs/jira-cli-mcp 还在维护吗?

最新版本 0.16.6 发布于 2026/10/31(11 天前);至今共发布 35 个版本,其中过去 12 个月发布了 35 个;首次发布于 2026/10/10。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。