08dde416b1
- Created a comprehensive analysis document for the backend architecture, detailing the directory structure, API routes, authentication workflows, and more. - Added a database architecture analysis report outlining the database structure, multi-tenancy architecture, and key system tables. - Introduced a frontend architecture analysis document that covers the directory structure, component systems, and Next.js App Router structure. These documents aim to enhance the understanding of the WACE ERP system's architecture and facilitate better workflow documentation. |
||
|---|---|---|
| .. | ||
| src | ||
| README.md | ||
| package-lock.json | ||
| package.json | ||
| tsconfig.json | ||
README.md
Multi-Agent Orchestrator MCP Server v2.0
Cursor Agent CLI를 활용한 멀티에이전트 시스템입니다. Cursor Team Plan만으로 동작 - 외부 API 키 불필요!
아키텍처
┌─────────────────────────────────────────┐
│ Cursor IDE (PM Agent) │
│ Claude Opus 4.5 │
└────────────────────┬────────────────────┘
│ MCP Tools
┌────────────────┼────────────────┐
▼ ▼ ▼
┌────────┐ ┌────────┐ ┌────────┐
│Backend │ │ DB │ │Frontend│
│ Agent │ │ Agent │ │ Agent │
│ via CLI│ │ via CLI│ │ via CLI│
│Sonnet │ │Sonnet │ │Sonnet │
└────────┘ └────────┘ └────────┘
↑ ↑ ↑
└──────────────┴───────────────┘
Cursor Agent CLI
(Team Plan 크레딧 사용)
특징
- API 키 불필요: Cursor Team Plan 크레딧만 사용
- 크로스 플랫폼: Windows, Mac, Linux 지원
- 진짜 병렬 실행:
parallel_ask로 동시 작업 - 모델 티어링: PM=Opus, Sub-agents=Sonnet
사전 요구사항
- Cursor Team/Pro Plan 구독
- Cursor Agent CLI 설치 및 로그인
# 설치 후 로그인 확인 agent status
설치
cd mcp-agent-orchestrator
npm install
npm run build
Cursor 설정
Windows
.cursor/mcp.json:
{
"mcpServers": {
"agent-orchestrator": {
"command": "node",
"args": ["C:/Users/YOUR_USERNAME/ERP-node/mcp-agent-orchestrator/build/index.js"]
}
}
}
Mac
.cursor/mcp.json:
{
"mcpServers": {
"agent-orchestrator": {
"command": "node",
"args": ["/Users/YOUR_USERNAME/ERP-node/mcp-agent-orchestrator/build/index.js"]
}
}
}
주의: Mac에서 agent CLI가 PATH에 있어야 합니다.
# agent CLI 위치 확인
which agent
# 보통: ~/.cursor-agent/bin/agent 또는 /usr/local/bin/agent
# PATH에 없으면 추가 (.zshrc 또는 .bashrc)
export PATH="$HOME/.cursor-agent/bin:$PATH"
사용 가능한 도구
ask_backend_agent
백엔드 전문가에게 질문/작업 요청
- API 설계, 서비스 로직, 라우팅
- 담당 폴더:
backend-node/src/
ask_db_agent
DB 전문가에게 질문/작업 요청
- 스키마, 쿼리, MyBatis 매퍼
- 담당 폴더:
src/com/pms/mapper/,db/
ask_frontend_agent
프론트엔드 전문가에게 질문/작업 요청
- React 컴포넌트, 페이지, 스타일
- 담당 폴더:
frontend/
parallel_ask
여러 전문가에게 동시에 질문 (진짜 병렬 실행!)
- 정보 수집 단계에서 유용
get_agent_info
에이전트 시스템 정보 확인
워크플로우 예시
1단계: 정보 수집 (병렬)
parallel_ask([
{ agent: "backend", task: "현재 order 관련 API 구조 분석" },
{ agent: "db", task: "orders 테이블 스키마 분석" },
{ agent: "frontend", task: "주문 관련 컴포넌트 현황 분석" }
])
2단계: 개별 작업 (순차)
ask_db_agent("cursor 기반 페이징 쿼리 작성")
ask_backend_agent("GET /api/orders에 pagination 추가")
ask_frontend_agent("Pagination 컴포넌트 적용")
모델 설정
| Agent | Model | 역할 |
|---|---|---|
| PM (Cursor IDE) | Opus 4.5 | 전체 조율, 사용자 대화 |
| Backend | Sonnet 4.5 | API, 서비스 로직 |
| DB | Sonnet 4.5 | 스키마, 쿼리 |
| Frontend | Sonnet 4.5 | 컴포넌트, UI |
비용 최적화: PM만 Opus, 나머지는 Sonnet 사용
환경 변수
LOG_LEVEL: 로그 레벨 (debug, info, warn, error)
트러블슈팅
Windows: agent 명령어가 안 됨
# PowerShell 실행 정책 확인
Get-ExecutionPolicy -List
# 필요시 변경
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
Mac: agent 명령어를 찾을 수 없음
# agent CLI 위치 확인
ls -la ~/.cursor-agent/bin/
# PATH 추가
echo 'export PATH="$HOME/.cursor-agent/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc
응답이 오래 걸림
- 정상입니다! 각 에이전트 호출에 15-30초 소요
parallel_ask로 병렬 처리하면 시간 절약
개발
# 개발 모드 (watch)
npm run dev
# 빌드
npm run build
# 테스트 실행
npm start
라이선스
MIT