Taskmaster AI | Cursor + MCP + Taskmaster AI 사용 가이드

다음 포스터는 Cursor IDE환경에서 Taskmaster AI를 활용하기 위한 기본 과정을 정리한 글입니다.

참고: https://github.com/eyaltoledano/claude-task-master/tree/main

---

1. Taskmaster AI 설치 ✅

npm i -g task-master-ai

• 사전 조건: Node.js 설치 필요

---

2. API Key 설정 파일 생성 ✅

프로젝트 루트에 .cursor/mcp.json 파일 생성 후 다음 내용 입력:

{
  "mcpServers": {
    "taskmaster-ai": {
      "command": "npx",
      "args": ["-y", "--package=task-master-ai", "task-master-ai"],
      "env": {
        "ANTHROPIC_API_KEY": "YOUR_ANTHROPIC_API_KEY_HERE",
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE",
        "OPENAI_API_KEY": "YOUR_OPENAI_KEY_HERE",
        "GOOGLE_API_KEY": "YOUR_GOOGLE_KEY_HERE",
        "MISTRAL_API_KEY": "YOUR_MISTRAL_KEY_HERE",
        "OPENROUTER_API_KEY": "YOUR_OPENROUTER_KEY_HERE",
        "XAI_API_KEY": "YOUR_XAI_KEY_HERE",
        "AZURE_OPENAI_API_KEY": "YOUR_AZURE_KEY_HERE"
      }
    }
  }
}

⚠️ 각 항목에 실제 API Key를 입력해야 정상 작동합니다. 나의 경우 ANTHROPIC_API_KEY와 OPENAI_API_KEY를 활용하였다. OPENAI_API_KEY를 활용하려 했는데 PRD.txt를 파싱하는 과정에서 파싱이 불가능하다 하여 그냥 ANTHROPIC_API_KEY도 같이 활용하는 식으로 하였다.

---

3. 모델 및 키 상태 확인 ✅

task-master-ai models

• 활성화된 모델 및 API 키 유효성 점검 가능

---

4. Cursor 설정 확인 ✅

• Settings > MCP > Enable 항목이 켜져 있는지 확인

---

5. 프로젝트 초기화 ✅

Cursor 내에서 다음 명령 실행:

Can you please initialize taskmaster-ai into my project?

수행 결과:

• 필요한 프로젝트 구조 자동 생성
• 초기 설정 파일 생성
• 다음 작업 단계 안내

---

6. Taskmaster AI 사용 방법 요약 ✅

• 자연어 명령으로 Taskmaster와 상호작용 가능
• 기본 흐름:
  1. PRD.txt 작성 (제품 요구 사항 문서)
  2. 이를 기반으로 task 자동 생성 및 관리
• 나의 PRD.txt는 다음처럼 작성해 보았다.

<context>
# Overview  
DirectX 12(DX12)를 활용하여 윈도우 환경에서 삼각형을 그리는 예제 애플리케이션을 개발합니다. 이 프로젝트는 DX12의 기본 렌더링 파이프라인을 이해하고, 최소한의 코드로 삼각형을 화면에 출력하는 것을 목표로 합니다. 주로 DX12 입문자, 그래픽스 프로그래밍 학습자, 관련 강의/워크숍 자료로 활용될 수 있습니다.

# Core Features  
- DX12 초기화 및 윈도우 생성
  - DX12 디바이스, 커맨드 큐, 스왑체인 등 필수 객체 생성
  - 윈도우(Win32 API) 생성 및 메시지 루프 구현
- 렌더 타겟 및 뷰포트 설정
  - 렌더 타겟 뷰(RTV) 생성 및 바인딩
  - 뷰포트/시저 렉트 설정
- 삼각형 렌더링
  - 정점 버퍼 생성 및 업로드
  - 간단한 셰이더(HLSL) 작성 및 컴파일
  - 파이프라인 상태 객체(PSO) 구성
  - 커맨드 리스트를 통한 드로우 호출
- 프레임 동기화 및 화면 출력
  - Fence를 이용한 GPU/CPU 동기화
  - 스왑체인 Present 호출

# User Experience  
- 사용자: DX12 입문자, 그래픽스 프로그래밍 학습자
- 주요 플로우: 프로그램 실행 → 윈도우 생성 → 삼각형이 화면에 출력됨
- UI/UX: 별도의 UI 없음, 단순히 삼각형이 중앙에 출력됨
</context>
<PRD>
# Technical Architecture  
- Win32 API 기반 윈도우 생성
- DX12 디바이스 및 렌더링 파이프라인 초기화
- 정점 버퍼 및 셰이더(HLSL) 리소스 관리
- 커맨드 큐/리스트, 스왑체인, RTV 등 DX12 핵심 객체 관리

# Development Roadmap  
- 1단계: 프로젝트 구조 및 빌드 환경 설정
- 2단계: 윈도우 생성 및 DX12 초기화
- 3단계: 렌더 타겟/뷰포트 설정
- 4단계: 정점 버퍼/셰이더 작성 및 삼각형 렌더링
- 5단계: 프레임 동기화 및 화면 출력
- 6단계: 코드 정리 및 주석 추가

# Logical Dependency Chain
- 1 → 2 → 3 → 4 → 5 → 6 순서로 진행
- 각 단계는 이전 단계가 완료되어야 다음 단계로 진행 가능

# Risks and Mitigations  
- DX12 API의 복잡성: 공식 문서 및 샘플 코드 참고, 최소 단위로 구현
- 윈도우/드라이버 호환성: 최신 Windows 10/11 환경 기준, 예외 처리 추가
- 빌드 환경 문제: Visual Studio 최신 버전 및 DX12 SDK 사용 권장

# Appendix  
- 참고 자료: Microsoft 공식 DX12 튜토리얼, DirectX-Graphics-Samples
- HLSL 기본 예제 코드 포함 예정
</PRD> 

---

마무리 📝

taskmaster ai의 환경이 잘 설정된 것 같다. 이제 주어진 task를 수행하도록 하면 될 것 같다. 다음 포스트에서는 task를 수행하게한 결과를 적을 것 같다.