Vooster AI MCP Server

AI 기반 개발 워크플로우를 위한 프로젝트 관리 기능을 제공하는 FastMCP 서버입니다.

주요 기능

• 프로젝트 연결 및 관리
• 태스크 목록 조회 및 관리
• 우선순위 기반 다음 태스크 추천
• Cursor IDE와 MCP 프로토콜을 통한 원활한 통합

사용 가능한 도구

• connect_project: 특정 프로젝트에 연결
• disconnect_project: 현재 프로젝트 연결 해제
• list_projects: 사용 가능한 모든 프로젝트 목록 조회
• read_project: 프로젝트 상세 정보 조회
• list_task: 연결된 프로젝트의 태스크 목록 조회
• read_task: 태스크 상세 정보 조회
• get_next_task: 우선순위 기반 다음 작업할 태스크 조회

설치 및 실행

개발 환경

# 의존성 설치
pnpm install

# 개발 서버 실행 (FastMCP 개발 모드)
pnpm dev

# MCP Inspector로 디버깅
pnpm inspect

# 빌드
pnpm build

# 프로덕션 실행
pnpm start

Cursor 연동

MCP 설정 파일에 다음과 같이 추가하세요:

{
  "mcpServers": {
    "pymm-ai": {
      "command": "node",
      "args": ["/path/to/pymm-ai/dist/index.js"],
      "env": {
        "VOOSTER_API_KEY": "your-api-key"
      }
    }
  }
}

환경 변수

• PYMM_API_KEY: Vooster AI API 액세스 키

아키텍처

이 서버는 FastMCP 프레임워크를 기반으로 구축되었으며:

• 간소화된 도구 등록: server.addTool() 방식
• 내장 로깅: 구조화된 로그 지원
• 오류 처리: UserError를 통한 사용자 친화적 오류 메시지
• 타입 안전성: Zod 스키마 직접 지원

개발자를 위한 정보

이 서버는 혼자 개발하거나 소규모 팀에서 AI 보조 개발 도구를 사용하는 개발자를 위해 설계되었습니다.

테스트

# 테스트 실행
pnpm test

# 테스트 커버리지
pnpm test:coverage

# 감시 모드로 테스트
pnpm test:watch

타입 검사

pnpm typecheck