mcp-development

MCP 개발 가이드라인

Model Context Protocol (MCP) 아키텍처

MCP 서버 구조

• 메인 서버: mcp-server/server.ts
• FastMCP 프레임워크: 빠르고 효율적인 MCP 서버 구현
• 도구 등록: MCP 도구들을 서버에 등록하고 관리

핵심 MCP 도구들

1. get-context: 프로젝트 컨텍스트 조회
2. init: 프로젝트 초기화

MCP 서버 개발 패턴

// MCP 도구 등록 예시
server.tool('tool-name', {
  description: '도구 설명',
  parameters: {
    // Zod 스키마를 사용한 파라미터 검증
  }
}, async (params) => {
  // 도구 로직 구현
});

CLI와 MCP 서버 통합

이중 진입점 구조

• CLI 진입점: context-compose → src/cli/index.ts
• MCP 진입점: context-compose-mcp → mcp-server/server.ts

공통 핵심 로직 공유

• core 모듈: CLI와 MCP 서버가 공통으로 사용하는 비즈니스 로직
• 타입 안전성: 동일한 TypeScript 타입과 스키마 공유

AI 모델 통합

Claude Desktop 설정

{
  "mcpServers": {
    "context-compose": {
      "command": "context-compose-mcp",
      "args": [],
      "cwd": "/path/to/project"
    }
  }
}

MCP 도구 디버깅

• 검사 명령어: npm run inspect - 개발 중인 MCP 서버 검사
• 빌드된 버전 검사: npm run inspect:built - 빌드된 MCP 서버 검사

Context 시스템 설계

YAML 기반 컨텍스트

version: 1
kind: task
name: 'feature-development'
description: '새로운 기능 개발을 위한 컨텍스트'

context:
  workflow: workflows/feature-workflow.yaml
  roles:
- personas/dan-abramov.yaml
  rules:
    - rules/clean-code.yaml
  mcps:
    - mcps/sequential-thinking.yaml

사전 정의된 컨텍스트들

• default: 기본 개발 컨텍스트
• feature: 새로운 기능 개발
• fix: 버그 수정
• refactor: 코드 리팩토링
• api: API 개발
• testing: 테스트 작성
• documentation: 문서 작업
• security: 보안 관련 작업
• performance: 성능 최적화

워크플로우 엔진

자동화된 작업 흐름

• 개발, 테스트, 배포 단계 자동화
• 역할 기반 개발 적용
• 알림 시스템과 통합

역할 기반 개발

• 전문가 페르소나: Dan Abramov, Martin Fowler 등
• 컨텍스트별 역할 적용: 각 컨텍스트에 적합한 전문가 관점 제공

테스트 전략

MCP 서버 테스트

• 통합 테스트: MCP 도구들의 정상 동작 검증
• Playwright 테스트: 실제 AI 모델과의 통합 테스트

CLI 테스트

• 단위 테스트: 개별 CLI 명령어 테스트
• E2E 테스트: 전체 워크플로우 테스트