AI导哈

Jira交付工具包

Jira Delivery MCP是一个围绕本地MCP服务器、可重用策略模块和可选Codex技能包的Jira操作工具包，适用于需要AI辅助Jira执行但不希望失去确定性工具、工作流意识或可审计性的团队。

  • by MacWulf
  • TypeScript
  • 本地部署
  • 3 星标
  • 更新于
在 GitHub 查看 MacWulf/jira-delivery-mcp

使用说明

Jira交付MCP

Jira Delivery MCP 是一个以本地MCP服务器、可重用策略模块和可选Codex技能包为中心的Jira操作工具包。

它是为那些希望在不损失确定性工具、工作流感知或可审计性的情况下，使用人工智能辅助Jira执行的团队而构建的。

当前版本： v0.3.0

这是给谁的

如果您希望助手帮助Jira完成以下工作，请使用此项目：

  • 安全地创建和更新问题
  • 明确地链接阻断器和依赖关系
  • 在行动之前发现目标项目的真实工作流程
  • 选择下一个符合条件的问题，而不是猜测
  • 从简报中引导一个新项目
  • 在确定性Jira工具表面上分层Codex技能

你今天能做什么

  • 为Jira和可选的Confluence操作运行本地MCP服务器
  • 将回购优先项目文档发布到Confluence中，并具有重复感知的追加销售行为
  • 计划汇流治理、过时性审查、元数据策略和文档索引结构，无不安全的管理员写入
  • 创建、更新、转换、评论和链接Jira问题
  • 检查项目工作流程，并从实际租户中导出生命周期语义
  • 在尝试管理员更改之前发现问题类型和字段策略功能
  • 从项目简报中引导启动器积压结构
  • 使用租户感知回退从验收标准生成验证工作
  • 使用结构化证据和关联的父级影响创建错误
  • 对传入的变更范围进行分类，并使用审计就绪的输出计划受控的Jira突变
  • 计划重新测试循环，而无需硬编码工作流或状态集
  • 将执行元数据存储在问题描述中，并在执行过程中解决它
  • 在拾取或开始工作之前验证依赖关系状态

v0.3.0中的亮点

  • 架构决策、ADR指导、硬约束、比例阻塞和下游Jira技能路由的架构师技能
  • 可公开发布的架构师文档和捆绑参考
  • 工作流感知问题状态协调，包括安全漂移修复的辅助回退
  • 有纪律的交付运动的准备和质量治理政策层
  • 变更控制计划表，用于在变更前对传入范围变更进行分类
  • 汇流发布和治理规划作为一流的可选功能
  • 扩展的Codex技能包，用于引导、执行、质量、文档和工作流管理

快速示例

典型流程：

  1. 启动MCP服务器。
  2. 阅读目标项目并发现其工作流程。
  3. 从简报中创建或改进初学者问题。
  4. 带有明确Jira问题链接的链接拦截器。
  5. 选择下一个符合条件的问题。
  6. 使用Jira提供的转换进行转换，而不是硬编码的假设。

兼容性

区域 状态 注释
Jira Cloud 支持 当前的实现目标是Jira Cloud REST API
Confluence集成 可选 仅当Confluence配置存在时才激活
团队管理的项目 支持 发现和执行是租户感知的
公司管理的项目 支持 管理员行为更敏感，应仔细验证
工作流突变 谨慎支持 推出前验证；视为高影响的管理工作
Codex技能 可选集成 有用，但不是运行MCP服务器所必需的
Windows DPAPI机密 支持 推荐的Windows本地机密选项
npm publish Disabled Root包是私有的，以防止意外的注册表发布；支持GitHub版本

安装

  1. 复制 .env.example 到 .env.

  2. 填写您的Jira配置。

  3. 安装依赖项：

    npm install

配置

最低Jira配置：

  • JIRA_BASE_URL
  • JIRA_EMAIL
  • JIRA_API_TOKEN 或 JIRA_API_TOKEN_DPAPI_FILE

可选但有用：

  • JIRA_DEFAULT_PROJECT_KEY
  • CONFLUENCE_BASE_URL
  • CONFLUENCE_EMAIL
  • CONFLUENCE_API_TOKEN 或 CONFLUENCE_API_TOKEN_DPAPI_FILE
  • CONFLUENCE_DEFAULT_SPACE_ID

看 秘密存储 为当地秘密处理提供指导。

快速开始

验证连接：

npm run smoke

启动MCP服务器：

npm run dev

验证工作区：

npm run check
npm run build

常用命令

npm run check
npm run build
npm run smoke
npm run dev

食品法典技能

该存储库还包括一个可选的Codex技能包，位于 skills/:

技能 它做什么
jira-core 核心操作模型：项目发现、租户感知Jira规则、问题分类和安全工具使用。
jira-architect 架构权威：ADR、硬约束、比例阻塞、系统边界决策和路由到其他技能。
jira-business-analysis 发现和需求塑造：目标、利益相关者、范围、未决问题和决策准备分析。
jira-project-bootstrap 项目启动：创建初始Jira结构、史诗、基线文档和交付流程。
jira-intake-refinement 待办事项清理：拆分、澄清、确定优先级，并为执行问题做好准备。
jira-quality-control 质量门：计划验证，检查验收证据，并防止不必要的用户审查。
jira-documentation-publishing 文档桥：保持仓库文档和Confluence页面对齐。
jira-execution-loop 交付循环：选择下一个逻辑问题，通过状态移动工作，并记录证据。
jira-workflow-admin 工作流管理：设计或调整Jira工作流、状态和面向管理员的配置。

这些技能旨在让租户了解：

  • 在假设工作流或问题类型行为之前，他们应该检查目标项目
  • 他们应该尽可能适应不同的Jira项目模型
  • 当请求的操作无法通过可用的AI工具或公共API安全完成时，他们应该告诉操作员需要哪个手动Jira步骤

要安装最新的本地Jira技能包并在Codex环境中注册内置的MCP服务器，请运行：

.\scripts\install-codex-local.ps1

此脚本：

  • 跑 npm run build
  • 同步来自的Jira技能 skills/ 进入 ~/.codex/skills
  • 更新 ~/.codex/config.toml 与当地 jiraDelivery 指向内置的stdio MCP服务器 services/jira-mcp-server/dist/index.js

每当您希望本地Codex安装从此存储库获取新的MCP或技能更改时，请重新运行它。

存储库结构

docs/                              Product and architecture documentation
fixtures/                          Reusable project-brief examples
scripts/                           Local helper utilities
services/jira-mcp-server/          MCP server, Jira client, policies, and tools
skills/                            Optional Codex skill package

文档

从这里开始：

其他参考文献：

安全

  • 默认情况下，Jira和Confluence的每日交付写入实时执行
  • 只有管理员风险写入需要明确确认
  • 显式预览模式仍然可用 JIRA_EXECUTION_MODE=dry-run
  • 工作流更改应在推出前进行验证
  • 依赖逻辑是显式的，基于链接
  • 机密不应提交到存储库

路线图

目前的重点领域包括：

  • 更丰富的质量编排和错误证据流
  • 变更请求影响分析
  • 跨不同Jira项目模型的问题类型启用
  • 更好的包装，便于重复安装和重复使用

贡献

看 贡献.md.

许可证

该项目根据 MIT许可证.

相关 MCP