AI导哈

工作流编排服务

Aurea Orchestrator MCP是一个生产就绪的MCP服务器，用于通过原子化、可组合的工具强制执行git/PR/Jira工作流。

  • by brianmontero18
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 brianmontero18/dev-mcp-tools

使用说明

Aurea编排器MCP

生产就绪的MCP服务器，用于使用原子可组合工具执行git/PR/Jira工作流。

快速开始

npm install
cp .aurearc.example.json .aurearc.json
cp .env.example .env
npm run build && npm start

添加到您的MCP主机

添加到您的Claude代码或Cursor MCP配置中：

{
  "mcpServers": {
    "aurea-orchestrator": {
      "command": "node",
      "args": ["/path/to/aurea-orchestrator-mcp/dist/index.js"]
    }
  }
}

所需配置

  • .aurearc.json -项目规则（分支命名、票证模式、受保护的分支）
  • GITHUB_TOKEN -GitHub个人访问令牌（必填）
  • JIRA_* -Jira凭据（可选，仅当使用Jira工具时）

从以下位置自动检测所有者/仓库 git remote origin.

可用工具

Git操作(aurea.git.*)

  • create_branch -创建具有强制命名和重复检测功能的分支
  • commit -英文常规提交，附有票参考
  • review_changes -热点差异总结（package.json、迁移等）
  • push -用受保护的树枝护栏推

拉取请求(aurea.pr.*)

  • compose -生成标准化的PR标题和正文
  • create -创建具有所有者/回购自动检测功能的PR
  • open - 一个电话：组合+推送+创建

Jira运营(aurea.jira.*)

  • get_ticket -获取门票详细信息（摘要、状态、受让人）
  • create_ticket -创建新的Jira票证
  • transition -将票移动到不同状态
  • ensure_ticket -遗留：验证或创建（首选get_ticket+create_ticket）

惯例

分支: feature/NT-1234-short-title 或 hotfix/NT-5678-fix-bug

承诺: feat(scope): message [NT-1234] （英语，祈使语气）

公共关系：使用模板自动生成（摘要、风险、检查表）

建筑

┌─────────────────────────────┐
│  HOST (Claude Code/Cursor)  │
│  - Reads user prompts       │
│  - Orchestrates workflow    │
│  - Asks for approval        │
└──────────┬──────────────────┘
           │ calls tools
           ↓
┌─────────────────────────────┐
│    Aurea MCP (this pkg)     │
│  - Atomic git operations    │
│  - PR creation with template│
│  - Jira integration         │
│  - Naming enforcement       │
│  - Safety guardrails        │
└─────────────────────────────┘

MCP提供工具。主持人精心策划。

用法示例

User: "Implement webhook retry for NT-1234"
    ↓
Host (using Aurea tools):
  1. aurea.jira.get_ticket({ ticket: "NT-1234" })
     ✓ "Add webhook retry mechanism"
  2. aurea.git.create_branch({ type: "feature", ticket: "NT-1234", title: "webhook retry" })
     ✓ feature/NT-1234-webhook-retry
  3. [Implements code]
  4. aurea.git.commit({ ticket, message: "add retry logic" })
  5. aurea.git.commit({ ticket, message: "add tests" })
  6. aurea.git.review_changes()
  7. [Asks user approval]
  8. aurea.git.push()
  9. aurea.pr.open({ type, ticket, title, summary })
 10. aurea.jira.transition({ ticket, status: "In Code Review" })
     ✓ PR: https://github.com/org/repo/pull/123

配置

看 docs/WORKFLOW_EXAMPLE.md 用于：

  • Claude代码斜线命令设置
  • 光标 .cursorrules 配置
  • 完整的工作流程示例
  • 最佳实践

主要特点

✅ 生产准备就绪：全面的错误处理、重试逻辑、令牌清理 ✅ 类型安全：带有Zod验证的完整TypeScript ✅ 原子工具：可组合操作，实现灵活的工作流程 ✅ 安全护栏：受保护的分支检查、工作树验证 ✅ 自动检测：来自git远程的所有者/仓库，上游分支处理 ✅ 结构化日志记录：清晰地了解运营情况 ✅ 重复检测：警告同一票证的现有分支机构

发展

npm run dev          # Run in dev mode
npm run build        # Build TypeScript
npm run check        # Type checking
npm run lint         # Lint code
npm run format       # Format with Prettier

许可证

麻省理工学院

相关 MCP