Jira交付MCP
Jira Delivery MCP 是一个以本地MCP服务器、可重用策略模块和可选Codex技能包为中心的Jira操作工具包。
它是为那些希望在不损失确定性工具、工作流感知或可审计性的情况下,使用人工智能辅助Jira执行的团队而构建的。
当前版本: v0.2.0
这是给谁的
如果您希望助手帮助Jira完成以下工作,请使用此项目:
- 安全地创建和更新问题
- 明确地链接阻断器和依赖关系
- 在行动之前发现目标项目的真实工作流程
- 选择下一个符合条件的问题,而不是猜测
- 从简报中引导一个新项目
- 在确定性Jira工具表面上分层Codex技能
你今天能做什么
- 为Jira和可选的Confluence操作运行本地MCP服务器
- 将回购优先项目文档发布到Confluence中,并具有重复感知的追加销售行为
- 计划汇流治理、过时性审查、元数据策略和文档索引结构,无不安全的管理员写入
- 创建、更新、转换、评论和链接Jira问题
- 检查项目工作流程,并从实际租户中导出生命周期语义
- 在尝试管理员更改之前发现问题类型和字段策略功能
- 从项目简报中引导启动器积压结构
- 使用租户感知回退从验收标准生成验证工作
- 使用结构化证据和关联的父级影响创建错误
- 对传入的变更范围进行分类,并使用审计就绪的输出计划受控的Jira突变
- 计划重新测试循环,而无需硬编码工作流或状态集
- 将执行元数据存储在问题描述中,并在执行过程中解决它
- 在拾取或开始工作之前验证依赖关系状态
v0.2.0中的亮点
- 工作流感知问题状态协调,包括安全漂移修复的辅助回退
- 有纪律的交付运动的准备和质量治理政策层
- 变更控制计划表,用于在变更前对传入范围变更进行分类
- 汇流发布和治理规划作为一流的可选功能
- 扩展的Codex技能包,用于引导、执行、质量、文档和工作流管理
快速示例
典型流程:
- 启动MCP服务器。
- 阅读目标项目并发现其工作流程。
- 从简报中创建或改进初学者问题。
- 带有明确Jira问题链接的链接拦截器。
- 选择下一个符合条件的问题。
- 使用Jira提供的转换进行转换,而不是硬编码的假设。
兼容性
| 区域 | 状态 | 注释 |
|---|---|---|
| Jira Cloud | 支持 | 当前的实现目标是Jira Cloud REST API |
| Confluence集成 | 可选 | 仅当Confluence配置存在时才激活 |
| 团队管理的项目 | 支持 | 发现和执行是租户感知的 |
| 公司管理的项目 | 支持 | 管理员行为更敏感,应仔细验证 |
| 工作流突变 | 谨慎支持 | 推出前验证;视为高影响的管理工作 |
| Codex技能 | 可选集成 | 有用,但不是运行MCP服务器所必需的 |
| Windows DPAPI机密 | 支持 | 推荐的Windows本地机密选项 |
安装
- 复制
.env.example到.env.
- 填写您的Jira配置。
- 安装依赖项:
npm install配置
最低Jira配置:
JIRA_BASE_URLJIRA_EMAILJIRA_API_TOKEN或JIRA_API_TOKEN_DPAPI_FILE
可选但有用:
JIRA_DEFAULT_PROJECT_KEYCONFLUENCE_BASE_URLCONFLUENCE_EMAILCONFLUENCE_API_TOKEN或CONFLUENCE_API_TOKEN_DPAPI_FILECONFLUENCE_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-corejira-business-analysisjira-project-bootstrapjira-intake-refinementjira-quality-controljira-documentation-publishingjira-execution-loopjira-workflow-admin
这些技能旨在让租户了解:
- 在假设工作流或问题类型行为之前,他们应该检查目标项目
- 他们应该尽可能适应不同的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许可证.
