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-创建具有所有者/回购自动检测功能的PRopen- 一个电话：组合+推送+创建
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许可证
麻省理工学院